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(54) Video on demand applet method and apparatus for inclusion of motion video in multimedia 
documents 



(57) The present specification describes a computer 
process which requests streams of motion video titles 
and decodes and displays the motion video signals of 
the stream for display in a computer display device is 
constructed in the form of an applet 21 2 of a multimedia 
document viewer 202 such as a World Wide Web brows- 
er. Accordingly, a designer of multimedia documents 
such as HTML pages can easily incorporate motion vid- 
eo titles into such HTML pages by specifying a few pa- 
rameters of a desired title or a desired portion of a title 
to be requested from a video server 250. The applet 21 2 
builds bit stream control signals from the specification 
of the title or the portion of the title. The bit stream control 
signals request transmission of the title or the portion of 
the title from a bit stream server such as a video server 



250 and are in a form appropriate for processing by the 
bit stream server. The applet 212 transmits the bit 
stream control signals to the bit stream server 250 to 
thereby request that the bit stream server 250 initiate 
transmission of a bit stream representing the requested 
title or the requested portion of the title. The applet 212 
also builds decoder control signals from the specifica- 
tion of the title or the portion of the title. The decoder 
control signals direct a bit stream decoder 204 to receive 
the requested bit stream from the bit stream server 250 
and to decode a motion video signal from the bit stream. 
The applet 21 2 transmits the decoder control signals to 
the decoder 204 to cause the decoder 204 to receive 
the bit stream and to decode the motion video signal 
from the bit stream. 
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Description 

A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclo- 
5 sure, as it appears in the Patent and Trademark Office patent file or records, but otherwise reserves all copyright rights 
whatsoever. 

FIELD OF THE INVENTION 

10 The present invention relates to computer graphical display of motion video and, in particular, to a method and 

apparatus for facilitating inclusion of motion video in multimedia computer displays. 

BACKGROUND OF THE INVENTION 

is Video servers, including networked video servers, transmit "bit streams" to a video client. Such bit streams, which 

are sometimes referred to as "streams, 0 generally represent video and/or audio signals which represent titles in a 
library of multimedia sources. Examples of titles of such a library typically include recordings of motion pictures. In 
general, a video server receives from a video client a request for a particular title and transmits a stream of the particular 
title to the video client. An example of a video client is a set top box which is generally known and which decodes the 

20 stream received from the video server and transmits the decoded signal to a connected television. The requesting of 
a particular title, receiving the stream of the particular title, and decoding the stream for display on a television are 
collectively and generally referred to as video on demand. 

Examples of such video on demand servers are described in U.S. Patent Application Serial Number 08/572,639, 
filed December 14, 1995 by Kallol Mandal and Steven Kleiman and entitled "Method and Apparatus for Delivering 

25 Simultaneous Constant Bit Rate Compressed Video Streams at Arbitrary Bit Rates with Constrained Drift and Jitter" 
(hereinafter the '639 Application) and in U.S. Patent Application Serial Number 08/572,648, filed December 14, 1995 
by Kallol Mandal and Steven Kleiman and entitled "Method and Apparatus for Distributing Network Bandwidth on a 
Video Server for Transmission of Bit Streams Across Multiple Network Interfaces Connected to a Single Internet Pro- 
tocol (IP) Network" (hereinafter the '648 Application). Both the '639 Application and the '648 Application are incorporated 

30 herein in their entirety by reference. 

The popularity of the Internet global network is growing extremely rapidly, and perhaps the most popular protocol 
of the Internet is the Hyper Text Transfer Protocol (HTTP) of the World Wide Web. According to the HTTP protocol of 
the World Wide Web, documents, which are generally referred to as "pages," incorporate text, graphical images, sound, 
and motion video which, when viewed, form a multimedia presentation to user. Such pages are typically viewed using 

35 a World Wide Web browser, which is a computer process capable of retrieving HTTP pages and presenting the contents 
of such pages to a user of a computer system through output devices such as a computer video display device and a 
computer audio circuit coupled to one or more audio speakers. An example of a World Wide Web browser is the 
Netscape browser available from Netscape Communications Corporation of Mountain View, California. 

To display motion video, conventional browsers typically (i) transfer to the computer system in which the browser 

40 executes an entire data file which includes data representing a title and (ii) subsequently initiate execution of a player 
computer process which displays the title to the user on a computer display device. The player computer process is 
separate from the browser and therefore displays the motion video of the title outside of the page displayed by the 
browser. In addition, transferring the entire data file prior to displaying the motion video of the title delays substantially 
the display of the motion video since such data files are typically quite large, e.g., typically 1.8 gigabytes of data to 

45 represent a two-hour, Vf4s-quality motion picture. 

Currently, no browser is capable of seamlessly integrating motion video streams into a page of the World Wide Web. 

SUMMARY OF THE INVENTION 

50 in accordance with the present invention, a computer process which requests streams of motion video titles and 

decodes and displays the motion video signals of the stream for display in a computer display device is constructed 
in the form of an applet of a multimedia document viewer such as a World Wide Web browser. Accordingly, a designer 
of multimedia documents such as HTML pages can easily incorporate motion video titles into such HTML pages by 
specifying a few parameters of a desired title or a desired portion of a title to be requested from a video server. The 

55 specification of the parameters is in the general form of a well-known parameter specification format dictated by the 
particular interface of the computer instruction language in which the applet is written. 

The applet builds bit stream control signals from the specification of the title or the portion of the title. The bit stream 
control signals request transmission of the title or the portion of the title from a bit stream server such as a video server 
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and are in a form appropriate for processing by the bit stream server. The applet transmits the bit stream control signals 
to the bit stream server to thereby request that the bit stream server initiate transmission of a bit stream representing 
the requested title or the requested portion of the title. 

The applet also builds decoder control signals from the specification of the title or the portion of the title. The 

s decoder control signals direct a bit stream decoder to receive the requested bit stream from the bit stream server and 
to decode a motion video signal from the bit stream. The applet transmits the decoder control signals to the decoder 
to cause the decoder to receive the bit stream and to decode the motion video signal from the bit stream. 

By using an applet of a multimedia document viewer to request and control receipt by a decoder of a motion video 
bit stream and to control decoding of the motion video bit stream by the decoder, a designer of a multimedia document 

10 can easily and conveniently include motion video images in multimedia documents. In addition, since the applet trans- 
mits bit stream control signals to a video server, the motion video signals which can be incorporated into a multimedia 
document are any such motion video signals stored in such a video server. Such video servers will likely include a 
large number and wide variety of motion video signals, thereby providing a wealth of motion video content for inclusion 
in multimedia documents. 

15 The present invention will now be further described, by way of example, with reference to the accompanying 

drawings, in which:- 

Figure 1 is a block diagram of a computer system which is connected to a video server through a network and 
which includes a multimedia document viewer which in turn processes an applet to include motion video images in a 
representation of a multimedia document in accordance with the presenting invention. 
20 Figure 2 is a block diagram showing the multimedia document viewer, applet, and video server of Figure 1 in 

greater detail. 

Figure 3 is a block diagram of an applet tag of Figure 2 in greater detail. 
Figure 4 is a block diagram of the applet of Figure 2 in greater detail. 

25 DETAILED DESCRIPTION 

In accordance with the present invention, a multimedia document 206 (Figure 2) includes an applet 214 which 
causes a multimedia document viewer 202 to execute an applet 212. Execution of applet 212 requests transmission 
of a bit stream of a particular title from a video server 250 and controls receipt and decoding of the bit stream by a 

30 decoder 204. Decoder 204, in response to control signals received from applet 212, decodes the received bit stream 
to produce a motion video image and displays the motion video image as an integral part of the representation of 
multimedia document 206. To include a motion video image as an integral part of a multimedia document, a designer 
of the multimedia document simply includes in the multimedia document an applet tag, e.g., applet tag 214, which 
specifies (i) applet 212, (ii) video servoer 250 as the source of a bit stream, and (iii) the particular bit stream to request 

35 from video server 250. A brief description of the operating environment of multimedia document viewer 202 and applet 
212 facilitates appreciation ofthe present invention. 

Figure 1 is a block diagram of a computer system 100 which is generally of the architecture of most computer 
systems available today. Computer system 100 includes a processor 102 which fetches computer instructions from a 
memory 104 through a bus 106 and executes those computer instructions. In executing computer instructions fetched 

40 from memory 104, processor 102 can retrieve data from or write data to memory 104, display information on one or 
more computer display devices 1 30, or receive command signals from one or more user-input devices 120. Processor 
102 can be, for example, any of the SPARC processors available from Sun Microsystems, Inc. of Mountain View, 
California. Memory 104 can include any type of computer memory including, without limitation, randomly accessible 
memory (RAM), read-only memory (ROM), and storage devices which include magnetic and optical storage media 

^5 such as magnetic or optical disks. Computer 100 can be, for example, any of the SPARCstation workstation computer 
systems available from Sun Microsystems, Inc. of Mountain View, California. 

Sun, Sun Microsystems, the Sun Logo, Java and Hot Java are trademarks or registered trademarks of Sun Mi- 
crosystems, Inc. in the United States and other countries. All SPARC trademarks are used under license and are 
trademarks of SPARC International, Inc. in the United States and other countries. Products bearing SPARC trademarks 

50 are based upon an architecture developed by Sun Microsystems, Inc. 

Computer display devices 1 30 can include generally any computer display device such as a printer, a cathode ray 
tube (CRT), light-emitting diode (LED) display, or a liquid crystal display (LCD). User input devices 120 can include 
generally any user input device such as a keyboard, a keypad, an electronic mouse, a trackball, a digitizing tablet, 
thumbwheels, a light-sensitive pen, a touch-sensitive pad, or voice-recognition circuitry. 

55 Computer system 100 also includes network access circuitry 140 which is coupled to processor 102 and memory 

1 04 through bus 1 06 and which is coupled to a network 1 50. In accordance with control signals received from processor 
1 02 through bus 1 06, network access circuitry 1 40 coordinates transfer of data through network 1 50 between network 
access circuitry 140 and similar network access circuitry (not shown) in computer 100B or other computer systems 
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coupled to computer system 1 00 through network 1 50. The transfer of data through network 1 50 is conventional. Since 
a video stream representing a VHS-quality motion picture encoded in MPEG-1 format has a bit rate of approximately 
1.5 Mbit/second to 2 Mbit/second, a useful minimum threshold is that network access circuitry 140 is capable of re- 
ceiving data at a rate of at least 2 Mbit/second. Higher quality motion video images have bit rates as high as 8 Mbit/ 
5 second or higher. Therefore, in one embodiment, network access circuitry 140 is capable of receiving data at a rate of 
at least 8 Mbit/second. Network access circuitry 140 can be generally any circuitry which is used to transfer data 
between a computer system and network such as computer system 100 and network 150 and can be, for example, 
an Ethernet controller chip. 

A number of computer processes execute in processor 102 from memory 104, including a multimedia document 

10 viewer 202 and a decoder 204. Multimedia document viewer 202 is a computer process which reads a multimedia 
document 206 and displays the multimedia information specified in multimedia document 206 in one or more of com- 
puter display devices 1 30. In one embodiment, multimedia document 206 is a document in HTML format and multimedia 
document viewer 202 is an HTML viewer such as the Netscape World Wide Web browser available from Netscape 
Communications Corporation of Mountain View, California. Multimedia document viewer 202 and multimedia document 

15 206 are shown in greater detail in Figure 2. 

Multimedia document viewer 202 retrieves data and tags from a multimedia document such as multimedia docu- 
ment 206. A tag is data which is not itself substantive content of a multimedia document but instead provides format 
information and can include specification of substantive content which is to be included in the multimedia document 
and which is located in memory 104 outside of multimedia document 206. For example, a tag can specify a file stored 

20 in memory 1 04 as containing a graphical image which is to be included as substantive content of multimedia document 
206. The data and tags of multimedia document 206 collectively define the composition, including substantive content 
and formatting, of multimedia document 206; and multimedia document viewer 202 displays such substantive content 
in one or more of computer display devices 1 30 (Figure 1 ) in accordance with the data and tags of multimedia document 
206. tn one embodiment, multimedia document 206 is an HTML document, and the data and tags of multimedia doc- 

25 ument 206 comport with the HTML language. Multimedia document 206 includes an applet tag 214 (Figure 2) which 
specifies an applet 21 2 and a number of operational characteristics of applet 21 2 as described more completely below. 

Multimedia document viewer 202 includes an applet interpreter 210 which retrieves from applet 212 computer 
instructions and translates such computer instructions into computer instructions of a form appropriate for execution 
by processor 102 (Figure 1) and submits the translated computer instructions to processor 102 for execution. In one 

30 embodiment, applet interpreter 210 (Figure 2) translates and submits for execution a single computer instruction of 
applet 21 2 prior to translation and submission for execution of a subsequent computer instruction of applet 21 2. Applet 
interpreter 210 can be, for example, the Java applet interpreter or the Hot Java World Wide Web browser available 
from Sun Microsystems, Inc. and, in such an embodiment, applet 212 comports with the Java computer instruction 
language interpreted by the Java applet interpreter. As described more completely below, applet 212 is a novel applet 

35 which, when executed by processor 102 (Figure 1) through applet interpreter 210 (Figure 2), requests a title from a 
video server 250 and causes the received bit stream representing the requested title to be decoded in a decoder 204 
and displayed in a computer display device as an integral part of a multimedia display of multimedia document 206. 
In executing the computer instructions of applet 212, applet interpreter 210 transmits, through network 150 (Figure 

1 ) , control signals to an applications programming interface (API) 252 (Figure 2) of a video server 250 which executes 
40 within a computer system 160 (Figure 1). Illustrative examples of video server 250 of computer system 160 are de- 
scribed in the '639 and '648 Applications. API 252 (Figure 2) of video server 250 implements a remote procedure calling 
(RPC) protocol in which API 252 controls video server 250 in response to control signals received by API 252. For 
example, in response to control signals which request a title and which are transmitted to API 252 by applet interpreter 
210, API 252 causes a bit pump 254 of video server 250 to initiate transmission through network 150 (Figure 1) to 

45 decoder 204 (Figure 2) of a bit stream representing the requested title. In addition, API 252 can transmit to applet 
interpreter 210 status information regarding a title stored within video server 250 or regarding a bit stream transmitted 
by bit pump 254 in response to control signals requesting such status information. 

Decoder 204 is a computer process executing within processor 102 (Figure 1) from memory 104. Decoder 204 
receives data representing a motion video display encoded in a particular format. In one embodiment, decoder 204 is 

50 the MPEG Expert (MPX) decoder available from Applied Vision and decodes motion video signals according to the 
MPEG-1 encoding format. Applet interpreter 210 transmits to decoder 204 control signals which control the decoding 
by decoder 204 of the bit stream received from bit pump 254 of video server 250. Specifically, applet interpreter 210 
transmits to decoder 204 control signals directing decoder 204 to start or stop decoding the bit stream received from 
bit pump 254 or specifying characteristics of the bit stream received from bit pump 254 such as the bit rate, encoding 

55 format, and the coordinates of a particular location within one or more of computer display devices 130 (Figure 1) in 
which to display the decoded motion video images. In addition, applet 212 determines which communications port 
through network access circuitry 140 (Figure 1) the bit stream is to be received and transmits to decoder 204 (Figure 

2) control signals identifying the selected communications port. Applet 212 can therefore determine which communi- 
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cations ports are used by other applications and can avoid conflicts resulting from access of decoder 204 of a com- 
munications port by selecting a communications port which is not used by another computer process of computer 
system 100 (Figure 1). 

Applet tag 214 is shown in greater detail in Figure 3. Applet tag 214 includes a number of fields which collectively 

5 define a bit stream to be received and decoded for display by decoder 204 (Figure 2). A field is a collection of data 
which collectively define a item of information. Applet tag 21 4 includes (i) an applet identifier field 302, (ii) a width field 
304, (iii) a height field 306, (iv) a server identifier field 308, and (v) an encoding format field 310. Applet tag 214 can 
also include any of the following optional fields: (vi) a title field 312, (vii) an image field 314, (viii) a play/pause field 
316, (ix) a start field 318, and (x) a duration field 320. 

10 Applet identifier field 302 specifies applet 212 as the applet to be retrieved and executed by applet interpreter 210. 

Width field 304 and height field 306 specify the width and height, respectively, in display coordinate space of a computer 
display device, i.e., specify the size of the viewport in which the decoded motion video image is displayed. Server 
identifier field 308 specifies video server 250 (Figure 2) as the source of the desired bit stream. Encoding format field 
310 (Figure 3) specifies the particular encoding format, e.g., MPEG 1 SYS encoding format, ofthe bit stream received 

is by decoder 204 (Figure 2). Title field 31 2 (Figure 3) specifies the particular title to be retrieved from server 250 (Figure 
2). Alternatively, title field 312 can specify the address of a multicast bit stream. 

Image field 314 (Figure 3), if included, specifies a still video image to be displayed in the space specified by width 
field 304 and height field 306 if the title specified by title field 312 is unavailable. Play/pause field 316, if included, 
specifies whether the motion video image received from video server 250 (Figure 2) is initially in a play state or in a 

20 paused state. Start field 318 (Figure 3), if included, specifies an offset into the title of a portion of the title, i.e., the point 
within the title at which the bit stream should begin. For example, start field 318 can specify that the requested bit 
stream begin at 3 minutes and 10 seconds into the title. Duration field 320, if included specifies the duration of a desired 
portion of the title. For example, duration field 320 can specify that a 30-minute portion of the title is requested. In one 
embodiment, start field 318 and duration field 320 are specified in terms of an integer number of nanoseconds. 

25 Thus, by specifying the few fields 'described above and shown in Figure 3, a designer of multimedia document 206 

can include as an integral part of multimedia document 206 a motion video image retrieved from video server 250. The 
following is an illustrative example of applet tag 214 in HTML format. 

<applet code^SunMediaCenterPiayerclass 0 width=704 height=520> 
30 <param name=port value= n 1 973 n > 

<param name=format value- u MPEG1SYS M > 
<param name=host value^sqas-es 
<param namedmg valuer 7images/bkgx.gif u > 
</applet> 

35 

Applet 212 (Figure 2) includes computer instructions which, when executed, request a title from video server 250 
and control decoding and display of the decoded motion video signals by decoder 204 and is shown in greater detail 
in Figure 4. The computer instructions of applet 21 2 are organized into various levels, each of which defines a respective 
component of the behavior of applet 212. Applet 212 includes a player level 402, an API level 404, a decoder level 

40 406, and a detailed decoder level 408. 

Player level 402 includes computer instructions which, when executed, implement a graphical user interface in 
which a user can control the bit stream received by video server 250 (Figure 2) and the display of the decoded motion 
video signals of the bit stream by physical manipulation of one or more of user input devices 120 (Figure 1). In one 
embodiment, the computer instructions of player level 402 (Figure 4), when executed, cause graphical and/or textual 

45 representation of control mechanisms to be displayed in one or more of computer display devices 1 30 (Figure 1 ). Such 
control mechanisms are known and conventional and include, without limitation, virtual buttons, pull-down menus, 
virtual radio buttons, virtual check boxes, and sliding scroll bars. In a conventional manner, a user activates one or 
more of such control mechanisms by physical manipulation of one or more of user input devices 120 (Figure 1) and 
such physical manipulation results in receipt by player level 402 (Figure 4) of applet 21 2 of signals and/or data repre- 

so senting such activation. 

API level 404 includes computer instructions wh ich, when executed, implement the RPC protocol of API 252 (Figure 
2) of video server 250 and invoke RPC calls to API 252 to control the bit stream transmitted by bit pump 254 in ac- 
cordance with interaction of a user with the graphical user interface implemented by player level 402 (Figure 4). 
Decoder level 406 and detailed decoder level 408 collectively control operation of decoder 204 (Figure 2), generally 

55 controlling the decoding of the bit stream received from video server 250 by decoder 204 and the display in a computer 
display device of the decoded motion video image. Decoder level 406 includes computer instructions and data struc- 
tures which are not specific to any particular decoder, while detailed decoder level 408 includes computer instructions 
and data structures which are specific to decoder 204. It is generally preferred that detailed decoder level 408 is as 
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small and simple as possible such that the majority of computer instructions of decoder levels 406 and 408 are included 
in decoder level 406. Accordingly, adapting applet 212 (Figure 2) to operate in conjunction with a decoder other than 
decoder 204 requires modification of only detailed decoder level 408 and, therefore, as little modification as possible. 

Appendix A is a computer source code listing of a preferred embodiment of applet 212. The modules of Appendix 
A are written in the Java applet computer instruction language developed by Sun Microsystems, Inc. of Mountain View, 
California The computer instructions of the Java applet computer instruction language are objectoriented, and each 
of the modules of Appendix A represents a respective class of objects. Player level 402 (Figure 4), in this embodiment, 
includes classes SunMediaCenterPlayer, Player, and PositionSlider as defined in the computer source code listing of 
Appendix A. API level 404, in this embodiment, includes classes MsmPlayer, MsmSession, MsmAccessRight, Msm- 
Persistence, MsmPlaylist, MsmToString, Msmltem, MsmTitleltem, MsmDeadAirltem, MsmException, XdrBlock, and 
PortMapper as defined in the computer source code listing of Appendix A. Decoder level 406, in this embodiment, 
includes classes Decoder and Decoderlmpl as defined in the computer source code listing of Appendix A. Detailed 
decoder level 408, in this embodiment, includes class MpxDecoderlmpI as defined in the computer source code listing 
of Appendix A. 

In the preferred embodiment of the present invention defined by Appendix A, a module "loop" includes computer 
instructions of the C computer instruction language and defines a loop computer process which executes independently 
of multimedia document viewer 202 (Figure 2). The loop computer process cooperates with multimedia document 
viewer 202 and decoder 204 to request and receive from video server 250 bit streams representing multicast motion 
video signals. 

The above description is illustrative only and is not limiting. The present invention is therefore defined solely and 
completely by the appended claims together with their full scope of equivalents. 
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Appendix A 



SunMediaCenterPlaver 
/* 

w * @ (#) SunMediaCenter Player .java 
* 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 
* 

* version 1.0 

is * author Christopher Lindblad 
+ 



20 



25 



30 



35 



45 



import j ava. applet . *; 
import java.awt.*; 
import java.net.*; 
import java.io.*; 
import COM.Sun.isg.smcjc.*; 

public class SunMediaCenterPlayer extends Applet { 
private Player player; 
private TextArea reporter; 
private Thread thread; 

public SunMediaCenterPlayer ( ) { 
setLayout (new BorderLayout ( ) ) ; 
player = new Player (); 
add ("Center"/ player) ; 

} 



public synchronized void initO ( 
if (reporter != null && reporter . getParent ( ) == this) { 
remove (reporter) ; 
40 reporter . setText ( ,( " ) ; 

validate ( ) ; 

} 

try { 

int port=getParameterInt ("port"/ -1) ; 
int vc=getParameterInt ( "vc", -1) ; 
if (vc!=-l) { 
player. init( 

getParameterRequiredC'host") , 
so getParameterRequired ("title" ) , 
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getParameterLong ("start", OL) , 
getParameterLong ( "duration" , OL) , 
getParameterString ("loop", 
false") .equalsIgnoreCase ("true" ) , 

getParameterString ("cmd", "play") / 
getParameter Image ( " img" , null ) , 
VC, " " / 

getParameterURL("CC") , 
getParameterRequired (" interface" ) ) ; 
} else { 

if (port==-l) { 
player. init ( 

getParameterRequired ("host") , 
getParameterRequired ( "title" ) , 
getParameterLong ("start", OL) , 
getParameterLong { "duration", OL) , 
getParameterString ( "loop", 
false" ) . equalsIgnoreCase ( "true" ) , 

getParameterString ("cmd", "play") , 
getParameter Image ("img", null) , 
port,"", 

getParameterURL("CC") ,null) / 
}else{ 
player . init { 

getParameterRequired ("host") , 
"none",0L,0L, false, "play", 
getParameter Image ("img", null) , 
port, 

getParameterRequired ( " format" ) , 

getParameterURL("CC") ,null) ; 

} 

) 

} catch (IOException e) { 

report (e, "parsing Sun MediaCenter player parameters"); 

} 

} 

public synchronized void start () { 
try player .start () ; catch (IOException e) 

report (e, "starting a Sun MediaCenter player"); 

} 

public synchronized void stopO { 
try player. stop () ; catch (IOException e) 

report (e, "stopping a Sun MediaCenter player"); 

} 
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private String getParameterRequired (String key) throws 
IOException { 

String val = getParameter (key) ; 
if (val != null) return val; 

throw new IOException ( "missing required parameter " + key); 

} 

private int getParameterlntRequired (String key) throws 
IOException { 

String val = getParameter (key) ; 
if (val != null) 

try return Integer .parselnt (val) ; catch 
(NumberFormatException e) 

throw new IOException ( 

"^parameter " + key + " is not a valid int: " + 

val); 

throw new IOException ("missing required parameter " + key); 

} 

private URL getParameterURL (String key) { 
URL res=null; 
String val = getParameter (key) ; 
if (val — null) return null; 
try res=new URL(val); 

catch (MalformedURLException e) try res=new 
URL (getDocumentBase ( ) , val) ; 

catch (MalformedURLException f) 
System. out .println ("MalformedURLException" ) ; 
return res; 

> 

private String getParameterString(String key, String dflt) { 
String val = getParameter (key) ; 
if (val == null) return dflt; 
return val; 

} 

private int getParameterlnt (String key, int dflt) throws 
IOException { 

String val = getParameter ( key) ; 
if (val — null) return dflt; 
try return Integer .parselnt (val) ; catch 
(NumberFormatException e) 

throw new IOException ( 
"parameter " + key + " is not a valid int: " + val); 

} 
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private long getParameterLong (String key, long dflt) throws 
IOException { 

String val = getParameter (key) ; 
if (val == null) return dflt; 

try return Long. parseLong (val) ; catch ( Number FormatExcept ion 

e) 

throw new IOException ( 
"parameter " + key + " is not a valid long: " + val); 

} 

private Image getParameterlmage (String key, Image dflt) { 
String val = getParameter (key) ; 
if (val == null) return dflt; 
return getlmag^ (getDocumentBase ( ) , val) ; 

} 

private synchronized void report (Exception e, String doing) { 
ByteArrayOutputStream os = new ByteArrayOutputStream ( ) ; 
PrintStream ps - new PrintStream (os) ; 
ps .print ( "An error occurred while " ); 
ps .print (doing) ; 
ps. printing : ") ; 
e.printStackTrace (ps) ; 
if (reporter == null) { 

reporter = new TextArea ("") ; 

reporter .setEditable (false) ; 

} 

reporter . appendText (os . toStr ing ( ) ) ; 
if (reporter. getParent () != this) { 

add ("North", reporter); 1 

validate ( ) ; 

} 

} 
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Player 

/* 

* @ (#) Player. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version l.lsc 

* author Christopher Lindblad ( Msm API & Mpx API ) 

* author Stephane CACHAT (Closed Caption & Multicasting) 

V 



package COM.Sun.isg. smcjc; 

import j ava. apple t.*; 

import java.awt.*; 

import java.io.*; 

import java.net.*; 



public class Player extends Panel implements Runnable { 
private long playDuration; 
private long startOffset; 
private long seekPosition; 
private long tellPosition; 
private double tellPositiond; 
private MsmPlayer player; 
private String host; 
private String titleName; 
private String msg; 
private String format; 
private Image img; 
private Thread thread; 
private Panel controlLine; 
private Panel controlButtons; 
private TextArea reporter; 
private Decoder decoder; 
private PositionSlider positionSlider ; 
private Button [] buttons; 
private int cmd = 999; 
private int initialCmd; 
private int port; 
private boolean loop; 
private boolean Msm; 
private URL CC; 
private List CCt; 
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10 



15 



20 



private int CCz=0; 

private String [] CCb-new String[1024] ; 

private Doublet] CCi=new Double [1024 ] ; 

private int CC1=0; 

private int CCo=0; 

private int CCm=0; 

private boolean playing = false; 

private TextField CCs; 

private String ATM; 

public Player () { 

setLayout (new BorderLayout () ) ; 

decoder = new Decoder (); 
^ add { "Center" , decoder); 

public synchronized void init( 
String host, String titleName, 

long startOffset, long playDuration, boolean loop, 
String and, Image img, int port, String format , URL CC, String 



ATM) 

throws IOException { 
25 URLConnection uc; 

Double d; 
String str; 
int i=0; 
int j=0; 

30 

thi s . por t=por t ; 

if ( (port !=-l) && (ATM==null) ) { 

Msm=false; 
}else{ 

35 Msm=true; 

this. initialCmd = parseCmd (cmd) 

this.CC=CC; 
this . ATM=ATM; 
this. host = host; 
this. titleName = titleName; 
this. startOffset = startOffset; 
this.playDuration = playDuration; 
this. loop = loop; 
this. img = img; 
this. format = format; 
if (CC!=null) { 
CCt= new List () ; 
so CCt .minimumSize (6) ; 



40 



45 



55 
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CCt .preferredSize (6) ; 
uc= CC , openConnection ( } ; 
DatalnputStreara in=new 
DataInputStream(uc.getInputStream() ) ; 
str="-"; 
CCb[i]=new StringC*") ; 
CCi[i]=new Double (0. 0); 
i++; 

while (in. available () >0) { 
str=in . readLine ( ) ; 
while 

( (str.trimO . length () ==0) && (in. available () >0) ) strain. readLine ( ) 
if (str!=null) { 

j=str . trim ( ) . indexOf ( 1 1 ) ; 
- i*f (j>0) { 

CCb[i]=new String (str. substring (j+1) ) .trim() ; 
CCt. addl tern (CCb [i ] ) ; 
if (CCb[i]==null) CCb[i]="*"; 
CCi[i]=new Double (str . substring (0, j ) . trim() ) ; 
i++; 

) 

} 

} 

CCm=i-l; 
in. close ( ) ; 

} 

} 

public synchronized void start () throws IOException { 
if (reporter != null && reporter .getParent ( ) == this) { 
remove (reporter) ; 
reporter . setText ( " " ) ; 
validate () ; 

} 

if (thread == null) { 
crod = initialCiad; 
thread = new Thread (this) ; 
thread. start () ; 

} 

} 

public synchronized void stop() throws IOException { 
if (thread != null) { 
thread = null; 
notify 0 ; 

} 

} 
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public synchronized boolean action (Event evt, Object arg) { 
if (buttons != null && evt. target instanceof Button) { 
Button b = (Button) evt. target; 
for (int i = 0; i < buttons . length; i++) { 
if (b == buttons [i]) cmd « i; . 

} 

notify () ; 

}; 

if (CC != null && evt. target ==CCt) t 
seekPosition = (long) (new 
Double (CCi[CCt.getSelectedIndex() ) .doubleValue () *10) .intValueO ) 
100000000; 

cmd = SEEK; 
notify (); 
}; 

if (CC != null SlSl evt.target==CCs) { 
if (CCKCCm) { 

CCz=CCl+l; 
}else{ 
CCz=0; 

}; 

while ( (CCz!=CCl) (CCb[CCz] .indexOf (CCs . getText ( ) ) <0) ) { 
CCz++; 

if (CCz>CCm) CCz=0; 

} 

if (CCb[CCz] .indexOf (CCs. getText 0 )>=0) { 
CCt. select (CCz) ; 
CCt .makeVisible (CCz+1) ; 
seekPosition = (long) (new 
Double (CCi [CCt. getSelectedlndex ( ) ] .doubleValue () *10) .intValueO ) 
100000000; 

cmd = SEEK; 
notify {) ; 
} 

} 

return true; 

> 

private void setConnect (MsmConnect connect) throws 
IOException { 
try { 

player .setConnect (connect) ; 
} catch (MsmException e) { 

/* Try it with destTiAddr in beta 0.5 syntax. */ 
System. out .print In ( , 'DesTiAddr=" + connect .destTiAddr ) ; 
InputStream is = new 
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StringBuf ferlnputStream (connect .destTiAddr) ; 

StreamTokenizer st = new StreamTokenizer (is) ; 
String host; 
int udpport; 

if (ATM-=null) { 
if (st .nextToken () — StreamTokenizer . TT_WORD 
St. sval. equals ("host") && 
st. nextToken () == ' = ' && 

st. nextToken () ~ StreamTokenizer .TT_W0RD && 
(host « st. sval) != null && 
st. nextToken () ~ ',' && 

st. nextToken () =- StreamTokenizer .TT_W0RD 
st. sval. equals ("udpport") && 
st .nextToken ( ) == r = ' 

st .nextTakenO == StreamTokenizer . TT_NUMBER && 
(udpport « (int) st .nval) != 0) { 
connect .destTiAddr = "beO, "+host+", "+udpport; 
player. setConnect (connect) ; 

} else { 
throw e; 

} 

}else{ 
throw e; 
} 

} 

} 

public synchronized void run() { 
Thread currentThread = Thread. currentThreadO ; 
MsmSession session = null; 
MsmTitle title = null; 

Msmltem[] items = null; 
int speed=0; 



if (Msm) { 

controlButtons = new Panel {); 
controlButtons . setLayout (new FlowLayout () ) ; 
controlButtons .add (cinds [PAUSE] , new 
Button (labels [PAUSE] ) ) ; 

controlLine = new Panel (); 
controlLine . setLayout (new BorderLayout ( ) ) ; 
controlLine. add ("East", controlButtons) ; 
positionSlider = new PositionSlider (this) ; 
controlLine. add ("Center", positionSlider) ; 
add ("South", controlLine) ; 

if (CC!=null) { 
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Panel CCp=new Panel (); 

CCp . setLayout (new BorderLayout ( ) ) ; 

Panel CCq=new Panel {); 

CCq. setLayout (new BorderLayout ( ) ) ; 

CCs= new TextField (15) ; 

CCs.isEditableO ; 
CCq . add ( " South" , CCs); 

Label l=new Label ("Search") ; 
CCq. add ("Center", 1) ; 

CCp. add ("East", CCq) ; 

CCp . add ( "Center" , CCt ) ; 
controlLine . add ( "North" , CCp ) ; 



try { 

if (Msm) { 

items = new Msmltemfl] ; 
session - new MsmSession (host ) ; 
title = session. getTitleStatus (titleName) ; 
if (playDuration ~ Oh) playDuration = 
title. totalPlayDuration; 

format=title . format; 

} 

decoder . init (format, img, host, port, ATM) ; 
if (Msm) { 

titlelnit (title) ; 
player = new MsmPlayer (session, info(), 
MsmPlayer . TIME^MAXTIME) / 

player . setPersistence (new MsmPersistence ( 
MsmPersistence . TYPE_N0NE, 
MsmPlayer .TIME J4AXTIME) ) ; 
items (0] = new MsmTitleItem( 
titleName, playDuration, startOffset, playDuration, 
playDuration, false, true, title .maxBitRate) ; 
player. setPlaylist (new MsmPlaylist ( 
MsmPlayer. TIME_CURRENT, loop, 0, 
MsmPlayer . T IME_MAXT IME , 

items, 0, 0)); 
setConnect (new MsmConnect ( 
decoder . destTiAddr ( ) , decoder . encap ( ) , 
title. maxBitRate) ) ; 

playing = false; 

speed = MsmPlayer ,SPEED_FORWARD; 
}else{ 

invalidate ( ) ; 
validate () ; 
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while (currentThread ~ thread) { 
switch (cmd) { 
case NOP: { 

if (Msm) { 

MsmPlayStatus status = 

player . getPlayStatus ( ) ; 

if (tellPosition != status . currentPosition) 
tellPosition = status .currentPosition; 
positionSlider . repaint ( ) ; 

} 

tellPositiond= ( tellPosition/1000000000) +3 . 0; 

if (CC!=null) { 
. w CCo=CCl ; 

while 

( (CCi [CC1+1] .doubleValue ( ) <tellPositiond) && (CCl+KCCm) ) CC1++ 

while 

( (CCi [CCI] .doubleValue ( ) >tellPositiond) && (CC1>0) ) CCI— ; 

if (CCol=CCl) { 

CCt-select (CC1-1) ; 
CCt.ma)eeVisible(CCl) ; 

) 

} 

player . setPersistence (new MsmPersistence ( 
MsmPer s i s t ence . T YPE_N0NE , 
status. currentDate+60*1000000000L) ) ; 

} 

break; 

} 

case PAUSE: { 

decoder. pause () ; 

if (Msm) player.pause(MsmPlayer.TIME_CURRENT) ; 
decoder- flush () ; 
playing - falser- 
decoder .play ( ) ; 
break; 

} 

case GOTO__START : { 

tellPosition = OL; 

if (Msm) positionSlider .repaint () ; 

decoder.stopO ; 

i f (Msm) player . play (MsmPlayer . S PEED_FORWARD , 
OL, 
OL, 

MsmPlayer . T IME_CURRENT ) ; 
decoder . flush () ; 



17 



EP 0 803 826 A2 



break; 

} 

case GOTOJEND: { 

tellPosition = playDuration; 

if (Msm) positionSlider. repaint () ; 

decoder .stop {) ; 

if (Msm) player . play (MsmPlayer . SPEED_REVERSE , 
playDuration, 
OL, 

MsmPlayer. TIME_CURRENT) ; 
decoder . flush ( ) ; 
break; < 

} 

case SEEK: { 

tellPosition = seekPosition; 
if (Msm) positionSlider .repaint () ; 
if (playing) { 
decoder . flush ( ) ; 
if (Msm) player .play (speed, 
seekPosition, 
MsmPl ay e r . T IME_MAXT IME , 
MsmPlayer. TIME_CURRENT) ; 

} else { 

long duration = S EEKDURAT I ON ; 

long position = seekPosition-duration; 

if (position < OL) { 

duration += positions- 
position -= position; 

} 

decoder .play ( ) ; 
decoder . flush ( ) ; 

i f (Msm) player .play (MsmPlayer . S PE E D_F0R WARD , 
position, 
duration, 

MsmPlayer . TIME_CURRENT) ; 

} 

break; 

} 

default: { 

decoder .play ( ) ; 
decoder . flush () ; 
if (Msm) { 

speed = cmd; 
player. play (speed, 

MsmPlayer . TIME_CURRENT, 
MsmPlayer . T IME_MAX T IME , 
MsmPlayer. TIME CURRENT); 
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playing = true; 

if (CC!=null) 
if (CCo!=CCl) { 

CCt . select (CC1-1) ; 
CCt .makeVisible (CCD ; 

} 

} 

} 
} 

cmd = NOP; 

try wait (100) ; catch (InterruptedException e) ; 

} 

} catch (Exception e) { 

report (e, "communicating with a Sun MediaCenter 
server" ) ; * 
} finally { 

try { 

try decoder. stop () ; catch (Exception e) 

report (e, "stopping a video decoder"); 

if (Msm) { 
if (player != null) { 

try player. deleteO ; catch (Exception e) 
report (e, "deleting a Sun MediaCenter 

player" ) ; 

player = null; 
} 

} 

} finally { 

if (Msm) { 
if (session != null) { 

try session .close () ; catch (Exception e) 
report (e, "closing a Sun MediaCenter 

connection") ; 

} 

} 

} 

} 

} 

/* 

* Callback from the PositionSlider . 

* Unsynchronized to avoid deadlock. 

* @return value between 0 and 1 indicating where in the 
we are. 

V 

public double tell() ( 
if (playDuration == 0L) return O.OD; 
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^return (double) tellPosition / (double) playDuration; 
/* 

* Callback from the PositionSlider . 

* Seek to a relative position in a file. 

* @param position Value between 0 and 1 

* indicating where in the file to ao. 
*/ 

public synchronized void seek (double position) { 

if (playDuration =- 0) return; 

seekPosition = (long) (position*playDuration) ; 

cmd = SEEK; 

notifyO ; 
} - * 

private String infoO throws UnknownHostException { 

String hostName = 
InetAddress . getLocalHost ( ) . getHos tName ( ) ; 

String java Version = System. getProperty { "java. version") 

String javaVendor = System. getProperty ("java. vendor") ; 

String osArch = System. getProperty ( "os . arch" ) ; 

String osName = System. getProperty ("os. name") ; 

String osVersion = System . getProperty ( "os .version" ) ; 

return hostName 

+ " Java " + javaVersion + » (" + javaVendor + ")" 
+ " (" + osArch + " " + osName + " " + osVersion + 



private void addButton (int i) { 
buttons [i] = new Button (labels [i] ) ; 
controlButtons.add(cmds ti] , buttons [i] ) ; 

/** 

* Initialize for a title. 

* @param title The title to play. 
*/ 

private void titlelnit (MsmTitle title) throws IOException { 
controlButtons.removeAll () ; 
buttons = new Button [ labels . length] ; 
for (int i = MsmPlayer . SPEED_SLOWEST_FORWARD; 

i <= MsmPlayer. SPEED SCENE FORWARD; 

i++) { 

if (title. speedScale [i] != 0) { 
addButton (GOTO START); 
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break; 

} 

} 

for (int i = MsmPlayer . SPEED_SCENE_REVERSE; 
i <= MsmPlayer . SPEED_SLOWEST_REVERSE ; 
i++> { 

if (title. speedScalefi} != 0) addButton (i) ; 

} 

addButton (PAUSE) ; 

for (int i = MsmPlayer. SPEED_SLOWEST_FORWARD; 
i <= MsmP layer. SPEED_SCENE_FORWARD; 
i++) { 

if (title. speedScale(i] != 0) addButton (i) ; 

} 

for (int i = M.smPlayer.SPEED_SCENE_REVERSE; 
i <= MsmPlayer. SPEED_SLOWEST_REVERSE; 
i++) ( 

if (title. speedScalefi] != 0) { 
addButton (G0TO_END) ; 
break; 

} 

} 

/* recompute layout */ 
controlLine. invalidate ( ) ; 
invalidate ( ) ; 
validate ( ) ; 

/* resize if we need to */ 
Component c = getParentO; 
while (c != null) { 

if (c instanceof Applet) { 

Dimension ps = c.preferredSize () ; 

Rectangle b = c.boundsO; 

if (ps. width != b. width | | ps. height != b. height) 
// This wedges Netscape Navigator 2.0 
// c. resize (ps .width, ps. height); 

} 

break; 

} 

} 

} 

private void report (Exception e, String doing) ( 
ByteArrayOutputStream os = new ByteArrayOutputStreamO 
PrintStream ps = new PrintStream (os) ; 
ps. print ("An error occurred while "); 
ps .print (doing) ; 
ps.printlnC':") ; 



21 



EP0 803 826 A2 



e .printStackTrace (ps) ; 
if (reporter == null) { 

reporter = new TextArea ("") ; 

reporter . setEditable( false) ; 

} 

reporter .appendText (os . toString ( ) ) ; 
if (reporter. getParent () != this) { 

add ("North", reporter); 

validate ( ) ; 

} 

} 

private int parseCmd (String cmd) throws IOException { 
for (int i « 0; i < cmds. length; i++) { 

if (cmd ..equalsIgnoreCase (cmds [i] ) ) return i; 

} 

throw new IOException ( "Not a valid Player command: "+cmd) 

} 

private static final long SEEKDURATION = 4000000000L; 

private static final int PAUSE =16; 
private static final int GOTO_START = 17; 
private static final int GOTO_END = 18; 
private static final int SEEK = 19; 
private static final int NOP = 20; 



private static final String [] labels = { 





// 


MsmPlayer. SPEED SCENE REVERSE 


"««", 




// MsmPlayer. SPEED FASTEST REVERSE 


"«<", 




// MsmPlayer. SPEED FASTER REVERSE 


"«", 




// MsmPlayer. SPEED FAST REVERSE 


tl ^ 11 


// 


MsmPlayer. SPEED REVERSE 


"l<\ 




// MsmPlayer. SPEED SLOW REVERSE 


" IK", 




// MsmPlayer . SPEED SLOWER REVERSE 


" 1 M<", 




// MsmPlayer. SPEED SLOWEST REVERSE 


">l 1 1 




// MsmPlayer. SPEED SLOWEST FORWARD 


">l 1", 




// MsmPlayer. SPEED SLOWER FORWARD 


">\", 




// MsmPlayer. SPEED SLOW FORWARD 


y f 


// 


MsmPlayer. SPEED FORWARD 


"»", 




// MsmPlayer. SPEED FAST FORWARD 


">»", 




// MsmPlayer. SPEED FASTER FORWARD 


"»»", 




// MsmPlayer. SPEED FASTEST FORWARD 


"»»| 


// 


MsmPlayer. SPEED SCENE FORWARD 


"II", 




// PAUSE 


" | |««", 


// 


GOTO START 


"»»| | 


// 


GOTO END 
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// SEEK 
// NOP 



>; 



private static fina 
"scene_reverse", 
" f astest_reverse" / 
"faster_reverse", 
"fast_reverse", 
"reverse", 
"slow_reverse" , 
" slower_reverse" , 
"slowest_reverse" / 
"slowest_forward", 
" slower_f orwaiyi" , 
"slow_f orward" , 
"play", 

"fast_f orward", 
" faster_f orward" , 
" fastest_f orward" , 
"scene_f orward", 
"pause", // 
"goto_starf ', 

"goto_end" , 

"seek", 

"nop", 

}; 



1 String I] cmds = { 

// MsmPlayer . SPEED_SCENE_REVERSE 
// MsmPlayer . SPEED_FASTEST_REVERSE 
// MsmPlayer . SPEED_FASTER_RE VERSE 

// MsmPlayer . S PEE D_FAST_RE VERSE 
// MsmPlayer. SPEED_REVERSE 

// MsmPlayer. S PEE D_SLOW_RE VERSE 
// MsmPlayer . SPEED_SLOWER_RE VERSE 
// MsmPlayer . SPEED_SLOWEST_REVERSE 
// MsmPlayer . S PEE D_SLOWEST_FORWARD 
/ / MsmPl ayer . SPEED_SLOWER_FORWARD 

// MsmPlayer. SPEED_SLOW_FORWARD 
// MsmPlayer. SPEED_FORWARD 

// MsmPlayer. SPEED_FAST_FORWARD 
// MsmPlayer . SPEED_FASTER_FORWARD 

// MsmPlayer . SPEED_FASTEST_FORWARD 
// MsmPlayer. SPEED_SCENE_FORWARD 
PAUSE 

// GOTO_START 
// GOTO_END 

// SEEK 
// NOP 
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PositionSlider 

/* 

* @(#) PositionSlider .java 



* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

V 

package COM.Sun.isg.smcjc; 

import java.awt.*; * 
import java.io.*; 

class PositionSlider extends Canvas { 
private Player player; 
private int hgap; 
private int vgap; 
private int wid; 

public PositionSlider (Player player) f 
^ this (player, 5, 5, 6) ; 

public PositionSlider (Player player, int hgap, int vgap, int 

this. player = player; 
this. hgap = hgap; 
this. vgap = vgap; 
this.wid = wid; 

} 

public void update (Graphics q) { 
paint (g); 

} 

public synchronized void paint (Graphics g) { 
Rectangle r = bounds (); 

int position = (int) ( (r . width-hgap*2) * D lav P r uiw,^ 
g.setColor(getBackgroundO); P^yer . tell ( ) ) +h gap; 

g.fillRect(0, 0, r. width, vgap*2) • 
2'^^o eC 5!S' r - hei 9^-vgap*2, r. width, vgap*2) ; 
g.fUlRectfO, vga P *2, r.width-hga P *2, r .he^t-vgap*2) ; 
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g.fillRect (r , width-hgap, vgap*2, r. width, r .height-vgap*2) ; 
g. fill3DRect (hgap, vgap*2, r . width-hgap+2, r .height-vgap*4, 
false) ; 

g* f ill3DRect (position-2, vgap, wid, r . height-vgap*2, true); 

) 

private synchronized void seek(int x) { 
Rectangle r » bounds (); 
double position = ((double) (x-hgap) ) / 
( (double) (r.width-hgap*2) ) ; 

if (position < 0.0D) position ~ 0.0D; 
if (position > 1.0D) position = 1.0D; 
player . seek (position) ; 



public boolean mouseDown (Event e, int x, int y) { 
seek (x) ; 
return true; 

} 



public boolean mouseDrag (Event e, int x, int y) { 
seek (x) ; 
return true; 

} 
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MsmPlaver 

/* 

* 6 (#)MsmPlayer. java. 



* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
+ 

V 

package COM.Sun.isg.smcjc; 

import java.io.*; * 

/** 

* Media Stream Manager Client API 

* MSM allows for the creation of "players". A player is a 
persistent entity p-^yer is a 

to a hat prOVides for the scheduled delivery of isochronous data 
m!inSis U a ar deStinatiorK To accomplish this task, a player 
thif ayliSt ° f titl6S ' the Stdte ° f a "P la y he ^" which traverses 

vlriouffunct'ons 311 300855 ^ COntrolli ^ wh ° P«for» 

* on the player. 



pS a S at PPUed " Uh UtleS that h3Ve been ""«">««« *« 

* switching necessary for "trick play". 

destiSt^nlof ^ 3 PlaYer 15 3 "^ h ^" ^at maintains a 
client) i l°nTl° n0nS (p0SSibly di ^erent than the controlling 

sele?ied P0Siti0n " travels alon< * the Playlist at the 

to g£ 8entation rate and Olivers isochronous data as scheduled 

* destination. The position, presentation rate, and 
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presentation direction 

* of the playhead can be controlled via playO, paused, and 
resume ( ) . The 

* initiation of play can be synchronized with "wall clock time" 
via play 0 ; 

* presentation will then stay synchronized with wall-clock time 
as long as 

* presentation rate and direction are Normal-Rate/ 
Forward-Direction. 

* Latency from invocation of the playO request until actual 
start of stream 

* may be reduced by "pre-rolling" with a playO request that has 
zero 

* duration. This jpay also be used to set a current playlist 
position without 

* actually starting play. 

* MSM manages concurrent updates to. a playlist by returning a 
modification 

* timestamp with playlist status. The modification timestamp 
indicates the 

* time of the last modification of the playlist. When a client 
wishes to 

* update a playlist, the client will first obtain status 
containing a 

* modification timestamp to understand the current state of the 
playlist. 

* Based on this status, the client then determines the 
appropriate updates 

* and passes those updates along with the modification timestamp 
of the 

* status on which the updates were based to msm. If msm finds 
that the 

* modification timestamp has not changed, implying that the 
clients updates 

* are based on currently valid playlist state, the playlist 
update will 

* succeed. If the modification timestamp indicates that the 
playlist has 

* been modified since this client obtained status, the update 
will be 

* rejected. In this case, the client should reobtain status, 
reaccess the 

* update, and then if appropriate resubmit the update with the 
modification 

* timestamp of the new status. There is a designated timestamp 



27 



EP 0 803 826 A2 

that forces 

* playlist modifications, this may be used if some external 
method of 

* concurrency control is preferred. 

* MsmPlaylist may be edit while play is in progress. Normally, 
changes to the 

* playlist will not take effect until the current item in play 
completes. A K y 

* playlist modification can be forced to take effect immediately 
by calling J 

* resume (). resume () should be called with the speed argument 
being the 

being rrSnt ^ dSSired neW Speed) and the startPosition argument 

* TIME_CURRENT. if the contents of the playlist at the current 

position of 

* the playhead have not been modified, this call will not 
disturb the 

outgoing data stream. 



* 
* 



MSM optionally maintains players persistently across server 
outages. When 

* this option is selected, a successful return from a player 
request * * 

* indicates that the player modifications have been made 
persistently. 

* Persistent players may optionally restart play on state 
recovery, play may 

' *>e restarted at the last played position or at the position 
tnat tne 

* position that play would be add had no outage occurred. 
control S list S read ^ m ° dify pla y ers is controlled by access 



* associated with the players. These may be modified by 
msmPlayerSetAccess () . 

# 

* Access rights are "Read", "Control", and "Admin". Read rights 
all state to y 

controlled" C ° ntro1 rightS allow "trick-play" operations to be 

* Admin rights allow creation of players, and connection, 
access, and 

* persistence attributes of players to be set. Access rights 
are associated y 

* with "agents" (eg users) appropriate for the authorization 
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mechanism 

* selected. The reserved agent name "*" represents ALL agents, 
those 

* granting a right to "* M , grants the right to all agents. 
V 

public class MsmPlayer { 

private MsmSession session; 
private byteU handle; 

/** 

* Creates a player. The player is initialized 
non-persistent . 

* Sparam session A server session. 

* @param info *Saved, but uninterpreted by server. May be 

null. 

* Used to describe the player for administrative purposes. 

* Sparam terminateDate Date at which player should be 
auto-deleted. 

* If TIME_MAXTIME, the player will never be auto-deleted, 
it must 

* be deleted via delete. 

* @exception IOException If an error has occurred. 
*/ 

public MsmPlayer (MsmSession session, String info, long 
terminateDate) 

throws IOException { 

this. session = session; 

XdrBlock call = session .newCall (PLAYER_CREATE) ; 

call. xdroutString (info) ; 

call .xdroutMsmTime (terminateDate) ; 

XdrBlock reply = session . rpc (call) ; 

handle = reply .xdrinBytes (HANDLELEN) ; 

reply. done () ; 

) 

MsmPlayer (MsmSession session, XdrBlock xdr) ( 
this. session = session; 
handle = xdr .xdrinBytes (HANDLELEN) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr.xdroutBytes (handle, HANDLELEN) ; 

} 

public MsmSession getSessionO { 
return session; 
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public byte[] getHandle () { 
return handle; 

} 

/** 

* Opens an existing player. 

* Sparam session A server session. 

* @param handle An opaque handle to the player, 

public MsmPlayer(MsmSession session, byte[] handle) ( 
this. session - session; 
this. handle = handle; 

> ■ 

stopped DeleteS player - In P r °9 res s Play of the player 
♦^exception IOException If an error has occurred. 

public void delete () throws IOException { 
XdrBlock call = session. newCall (PLAYER DELETE) - 
this. xdrout (call) ; _ 

^ session. rpc (call) .done() ; 

/** 

* Modifies access control list for player 

* Oparam rights The access modifications." 

* iexception IOException If an error has occurred 



IOExStion V f d SetAcCess(MsmAccessRi 9ht[] rights) throws 

XdrBlock call = session. newCall (PLAYER SETACCESS) ; 
this. xdrout (call) ; - 
call . xdroutlnt (rights . length) ; 
for (int i = 0; i < rights . length; i++) 
rights [i) .xdrout (call) ; 

^ session. rpc (call) .done() ; 

/** 

* Get access control list for player. 

* @return The access modifications. 

* eexception IOException If an error has occurred 

/ 
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public MsmAccessRight [] getAccessO throws IOException { 
XdrBlock call = session . newCall (PLAYERJ3ETACCESS) ; 
this. xdrout (call) ; 
XdrBlock reply = session. rpc (call) ; 
MsmAccessRight [ ] result = new 
MsmAccessRight [reply. xdrinlnt () ] ; 

for (int i = 0; i < result . length; i++) { 
result[i] = new MsmAccessRight (reply) ; 

} 

reply. done () ; 
return result; 

} 

/** 

* Sets persistence for player. 

* @param prstp A MsmPersistence containing the persistence 
to be set. 

* @exception IOException If an error has occurred. 
*/ 

public void setPersistence (MsmPersistence prst) throws 
IOException { 

XdrBlock call = session. newCall <PLAYER_SETPERSISTENCE) ; 
this. xdrout (call) ; 
prst .xdrout (call) ; 
session. rpc (call) .done ( ) ; 

} 

f-k * 

* Get persistence information for player. 

* @exception IOException If an error has occurred. 

*/ 

public MsmPersistence getPersistence ( ) throws IOException { 
XdrBlock call = session. newCall (PLAYER_GETPERSISTENCE) ; 
this .xdrout (call) ; 

XdrBlock reply = session. rpc (call) ; 
MsmPersistence result = new MsmPersistence (reply) ; 
reply .done () ; 
return result; 

} 

/** 

* Replaces a portion of the playlist for this player. The 
portion to be 

* replaced and the new titles to inserted are indicated via 
MsmPlaylist 

* struct pointed to by playlistp. 

* @param playlist A MsmPlaylist that indicates the period on 
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to be (re) scheduled and the new titles to place within 
that period. 



*/ 



the playlist 
to 1 
»riod. 

^exception IOException If an error has occurred. 

public void setPlaylist (MsmPlaylist playlist) throws 
IOException { 

XdrBlock call = session. newCall (PLAYER SETPLAYLIST); 
this .xdrout (call) ; ~ 
playlist .xdrout (call) ; 
session. rpc (call) .done() ; 

) 

/** 

* Obtains a .pqption of the playlist for this player. 

* @param startPosition The position within the playlist at 
which to start 

* returning status. 

* @param playlistDuration The number of milliseseconds of 
the playlist for 

* which to return status. 

* ©exception IOException If an error has occurred. 
*/ 

public MsmPlaylist getPlaylist (long startPosition, loner 
playlistDuration) y 
throws IOException { 

XdrBlock call = session. newCall (PLAYER GETPLAYLIST); 
this. xdrout (call) ; ~ 
call . xdroutMsmTime ( startPosition) ; 
call . xdroutMsmTime (playlistDuration) ; 
XdrBlock reply = session . rpc (call ) ; 
MsmPlaylist result = new MsmPlaylist (reply) ; 
reply.doneO ; 
return result; 

} 

/** 

* Obtains the playlist for this player. 

* @exception IOException If an error has occurred. 

* / 

public MsmPlaylist getPlaylist ( ) throws IOException { 
^return getPlaylist (TIME_ZERO, TIME_MAXTIME) ; 

/ * * 

* MsmConnects a player to the specified destination address 
An error is return if play is in progress at the time of a 
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setConnect () . 

* @param connect A MsmConnect instance containing a 
transport-independent 

* address string for the destination of Media Server data 
controlled 

* by this player. A connectp of NULL disconnects the 
player from the 

* current destination* 

* @exception IOException If an error has occurred. 
*/ 

public void setConnect (MsmConnect connect) throws IOException 

i 

XdrBlock call = session. newCall (PLAYER_SETCONNECT) ; 
this .xdrout (call) ; 
connect •xdrout e ( call) ; 
session . rpc (call) . done ( ) ; 

} 

* Get current connection for player. 

* @exception IOException If an error has occurred. 
V 

public MsmConnect getConnect() throws IOException { 
XdrBlock call = session. newCall (PLAYER_GETCONNECT) ; 
this -xdrout (call) ; 

XdrBlock reply = session. rpc (call) ; 
MsmConnect result = new MsmConnect (reply) ; 
reply. done ( ) ; 
return result; 

} 

/ * * 

* Schedules play to commence at startDate. Play 

* will begin at playlist startPosition and continue for 
playDuration NPT 

* seconds or until paused. An error is returned if the 
player is not 

* connected. 

* Only one playO command can be pending, a second play() 
overrides, any 

* pending play ( ) . 

* @param speed The speed at which to play. 

* @param startPosition The position within the playlist at 
which to begin 

* play. TIME_CURRENT means the current play position, 

* @param playDuration The duration of play. 

* TIME MAXTIME indicates "forever". 
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* @param startDate The wall-clock time of day at which to 
begin play. 

* A value of TIME_CURRENT means start play immediately. 

* @exception IOException If an error has occurred. 
*/ 

public void play( 
int speed, long startPosition, long playDuration, long 
startDate) 

throws IOException { 

XdrBlock call = session .newCall (PLAYER PLAY) ; 

this .xdrout (call) ; 

call -xdroutlnt (speed) ; 

call. xdroutMsmTime (startPosition) ; 

call. xdroutMsmTime (playDuration) ; 

call.xdroiitMsmTime (startDate) ; 

session. rpc (call) .done() ; 

\ 

/** 

* Pauses play on the player. 

* Only one pause () command can be pending, a second pause () 

* overrides any pending pause () . 

* (?param pausePosition The position within the playlist at 
which to pause 

* playing. If current play position is later than 
pausePosition 

* (taking into account the direction of play), play pauses 
immediately. 

A value of TIME_CURRENT means stop immediately. 

* Oreturn The time at which play actually paused. 

* ^exception IOException If an error has occurred. 
*/ 

public long pause (long pausePosition) throws Exception { 
XdrBlock call = session .newCall (PLAYER PAUSE); 
this. xdrout (call) ; 
call .xdroutMsmTime (pausePosition) ; 
XdrBlock reply = session. rpc (call) ; 
long result = reply .xdrinMsmTime () ; 
reply. done () ; 
return result; 

} 

/* ★ 

* Resumes playing. Play will continue until paused 

* or the end of the playlist. (looped playlists play 
forever) . 

* @param speed The speed at which to resume play. 
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* @param startPosition The position within the playlist at 
which to 

* resuine play. TIME_CURRENT means the current play 
position. 

* @exception IOException If an error has occurred. 
*/ 

public void resume (int speed/ long startPosition) throws 
IOException { 

XdrBlock call = session. newCall (PLAYER_RESUME) ; 

this. xdrout (call) ; 

call. xdroutlnt (speed) ; 

call . xdroutMsmTime (startPosition) ; 

session. rpc (call) .done {) ; 

} 

* Get play state for a player. 

* Qreturn A MsmPlayStatus instance. 

* @exception IOException If an error has occurred. 
V 

public MsmPlayStatus getPlayStatus ( ) throws IOException { 
XdrBlock call = session. newCall (PLAYER_GET PLAYS TATUS) ; 
this .xdrout (call) ; 

XdrBlock reply = session. rpc (call) ; 
MsmPlayStatus result = new MsmPlayStatus (reply) / 
reply. done () ; 
return result; 

) 



public String toStringO { 
return MsmToString.playerToString (this) ; 

} 



private static final int HANDLE LEN = 12; 



public static final long TIME 

public static final long TIME^ 

public static final long TIME^ 

public static final long TIME 

public static final long TIME 



BAD TIME = -1L 

CURRENT = -2L 

"ZERO = 0L 

MAXTIME = 2147483647999999999L 

MINTIME = 1L 



public static final int 
public static final int 
public static final int 
public static final int 
public static final int 
public static final int 



SPEED_SCENE_REVERSE = 0; 
SPEED_FASTEST_REVERSE = 1; 
SPEED_FASTER_REVERSE = 2; 
SPEED_FAST_REVERSE - 3; 
SPEED_REVERSE = 4; 
SPEED SLOW REVERSE = 5; 
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public static final int SPEED_SLOWER_RE VERSE = 
public static final int SPEED_SLOWEST_REVERSE = 
public static final int SPEED_SLOWEST_FORWARD = 
public static final int SPEED_SLOWER_FORWARD = 
public static final int SPEED_SLOW_FORWARD =10 
public static final int SPEEDJTORWARD = 11; 
public static final int SPEED_FAST_FORWARD = 12 
public static final int SPEED_FASTER_FORWARD = 
public static final int SPEED_FASTEST_FORWARD = 
public static final int SPEED_SCENE_FORWARD = 1 

private static final int PROG = 0x206d736d; 
private static final int VERS = 1; 

private static -final int SERVER_AUTHTYPE 
private static final int PLAYE RECREATE 
private static final int PLAYER_DELETE 
private static final int PLAYER_LIST 
private static final int PLAYER_SETACCESS 
private static final int PLAYER_GETACCESS 
private static final int PLAYER_SETPERSISTENCE 
private static final int PLAYER_GETPERS I STENCE 
private static final int PLAYER_SETPLAYLIST 
private static final int PLAYER_GETPLAYLIST 
private static final int PLAYER_SETCONNECT 
private static final int PLAYER_GETCONNECT 
private static final int PLAYERJPLAY 
private static final int PLAYER_PAUSE 
private static final int PLAYER_RESUME 
private static final int PLAYER_GETPLAYSTATUS 
private static final int TITLE GETSTATUS 
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MsmSession 
/* 

* @ (#)MsmSession. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

V 

package COM. Sun. isg. smcjc; 

import java.io.*; * 
import java.net.*; 
import java.util.*; 

/* * 

* Media Stream Manager Client API 
★ 

* The Media Stream Manager (msm) API provides an RPC interface 
for managing 

* the scheduling and play of isochronous media streams. 
V 

public class MsmSession { 

private String serverHostName; 
private Socket socket; 
private Inputs tream is; 
private OutputStream os; 
private int prog; 
private int vers;. 

★ 

* Create a RPC session for the named server. 

* @param serverHostName The host name of a MSM server. 

* Gexception IOException If an error has occurred. 
V 

public MsmSession (String serverHostName) throws IOException 
this. serverHostName = serverHostName; 
socket = new Socket (serverHostName, pmapGetPort ()) ; 
is = new Buf f eredInputStream(socket . getlnputStream ( ) ) ; 
os « new Buf feredOutputStream(socket .getOutputS tream ( ) ) ; 

} 

private int pmapGetPort ( ) throws IOException { 
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PortMapper pmap = null; 
try { 

pmap = new PortMapper (serverHostName) ; 
int port; 
prog = 100236; 
vers = 1; 

port = pmap. getPort (prog, vers, PortMapper. IPPROTO TCP) 
if (port != 0) return port; 
prog = 0x206d736d; 
vers = l; 

port = pmap. getPort (prog, vers, PortMapper . IPPROTO TCP) 
if (port != 0) return port; " 
} finally { 

if (pmap != null) pmap. close () ; 

^ throw new MsmException ( "no msra server on ,, + serverHostName) ; 
/** 

* Closes a session with an MSM server. 

* @exception MsmException If an error has occurred. 
V 

public void closed throws IOException { 
socket. close () ; 

} 

* All players on this server. 

* @return an array of all players. 

* ^exception IOException If an error has occurred 
*/ 

public MsmPlayer [] players () throws IOException { 
XdrBlock reply = rpc (newCall (PLAYER_LIST) ) ; 
MsmPlayer[] result = new MsmPlayer [reply .xdrinlnt ()) ; 
for (int i = 0; i < result . length; i++) { 
result [i] = new MsmPlayer (this, reply); 

reply. done ( ) ; 
return result; 

} 

/ + * 

* Obtains status about titles. 

* @param titleName The name of the title on which to obtain 
status . 

* Greturn the status of the title. 

* @exception IOException If an error has occurred. 
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*/ 

public MsmTitle getTitleStatus (String titleName) throws 
IOException { 

XdrBlock call = newCall (TITLE_GETSTATUS) ; 
call .xdroutString (titleName) ; 
XdrBlock reply = rpc(call); 

MsmTitle result = new MsmTitle (reply) ; 
reply .done () ; 
return result; 

} 

/* * 

* Returns the server host name. 
*/ 

public String getServerHostName () { 
return serverHostName; 

} 

XdrBlock newCall(int proc) { 
return new XdrBlock (prog, vers, proc); 

} 

synchronized XdrBlock rpc (XdrBlock call) throws IOException 
call . send (os) ; 

XdrBlock reply = new XdrBlock (is) ; 
try { 

reply. xdrinReplyHeader (call .callXid () ) ; 
} catch (IOException e) { 

throw new MsmException (call . callProc ( ) , e . getMessage ( ) ) 

} 

int err = reply .xdrinlnt () ; 

if (err != 0) throw new MsmException (call .callProc () , err) ; 
return reply; 

} 



public String toStringO { 
return MsmToString. sessionToString (this) ; 

} 



private 


static 


final 


int 


SERVER 


AUTHTYPE 




1 


private 


static 


final 


int 


player" 


"create 
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private 


static 


final 
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player" 


"delete 
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private 


static 


final 
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"GETACCESS 
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private static final int PLAYER_SETPLAYLIST 

private static final int PLAYER_GET PLAYL 1ST 

private static final int PLAYER_SETCONNECT 

private static final int PLAYERJ3ETCONNECT 

private static final int PLAYER_PLAY 

private static final int PLAYER_PAUSE 

private static final int PLAYER_RESUME 

private static final int PLAYERJ3ET PLAYS TATUS 

private static final int TITLE GETSTATUS 
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MsmAccessRight 
/* 

* @ (#) MsmAccessRight . java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM. Sun. isg. smcjc; 

/** * 

* Access types, operations on access lists, and rights and 

* lists of access rights. 

* Access types (read, admin, control) are the access catagories 

* defined by the MSM server (see MSM doc for each request to 

* determine the access catagory of that request). Access op's 

* are the operations that can be made to alter access rights of 

* a particular user. An access right is the pairing of access 

* catagories with a particular user. An access list is a 
collection 

* of access rights for multiple users. 
*/ 

public class MsmAccessRight { 
public String name; 
public int access; 
public int op; 

public MsmAccessRight (String name, int access, int op) { 
this. name = name; 
this. access = access; 
this. op = op; 

} 

MsmAccessRight (XdrBlock xdr) { 
name = xdr .xdrinString ( ) ; 
access = xdr .xdrinlnt () ; 
op = xdr .xdrinlnt () ; 

} 

void xdrout (XdrBlock xdr) { 
xdr .xdroutString (name) ; 
xdr .xdroutlnt (access) ; 
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xdr.xdroutlnt (op) ; 

} 

5 public String toStringO { 

^return MsmToString . accessRightToString ( this) ; 

public static final int ACCESS_NONE = 0; 
public static final int ACCESS_ADMIN = 1; 
public static final int ACCESS_READ = 2; 
public static final int ACCESS_C0NTROL == 4; 
public static final int ACCESS_ALL = 7; 

public static final int OP_ADD = 0; 
public static 4inal int 0P_REM0VE = 1; 
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MsmPersistence 

/* 

* @ ( ff ) MsmPersistence . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
★ 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM. Sun. isg. sracjc; 

/** * 

* MsmPersistence information 
*/ 

public class MsmPersistence { 

* Indicates the date at which the player should be 

* automatically deleted. On terminateDate, play if in 
progress, will 

* be stopped and the player deleted. A terminateDate of 
MSMT IME_MAX T IME 

* indicates the player should never be automatically 
deleted. 

V 

public long terminateDate; 
public int type; 

public MsmPersistence (int type, long terminateDate) { 
this. type = type; 

this . terminateDate = terminateDate; 

} 

MsmPersistence (XdrBlock xdr) { 
type = xdr .xdrinlnt ( ) ; 
terminateDate = xdr .xdrinMsmTime ( ) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr .xdroutlnt (type) ; 
xdr .xdroutMsmTime (terminateDate) ; 

} 
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Public String toStringf) [ 

} return "String. persistenceToString (this) ; 

^No persistence across server outage, 
public static final int TYPE_N0NE = 0; 

restarted StatiC Stat * ^ Preserved, play not is not 

*/ 

Public static final int TYPE_PLAYLIST = 1; 
t/l-y is restarted after outage at last^nown ^Position 

Public static final int TYPE_PLAYPOSIT10N = 2; 
date/ Pl3y iS reStarted -fter outage as appropriate for current 
} Public static final int TYP E _ PLAYCURDATE . 3; 
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MsmPlavlist 

"/* 

* @ (#)MsmPlaylist. java 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

package COM.Sun.isg.smcjc; 

/** . - * 

* MsmPlaylist positions are measured in seconds and nanoseconds, 
titles on a 

* playlist may be scheduled to start at any non-negative 
position. (In some 

* cases it may be convenient to base playlists positions at 0; 
in other 

* cases it may be better to base them with the OS representation 
of 

* time-of-day . ) The playlist maintains a contiguous sequence of 
titles and 

* "dead air" . A schedule may be edited by replacing any 
contiguous 

* sub-sequence of the schedule with another sequence. It is 
also possible 

* to change the starting position of the scheduled list of 
titles* Because 

* of mfs "admission delays", title start times may slip; msm 
optionally 

* allows a title to be padded with dead air that can absorb the 
slip, or on 

* a slip the same title or a later title can be marked to be 
truncated or a 

* later title may be " joined-in-progress" to absorb the slip and 
maintain 

* schedule correspondence with clock time. 
V 

public class MsmPlaylist { 
/** 

* On Get, the current modification status stamp. On Put, 
mods tamp on 

* which mods are based, if modification status has changed. 
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Mods are 

* aborted unless modstamp == MsmPlayer . TIME_CURRENT, in 
which case mods 

* are always done. 
V 

public long modstamp; 
/** 

* On Get, the starting playlist position for the returned 
playlist items 

* on Put, the playlist position where items are to be 
replaced* 

V 

public long editStartPosition; 
/** 

* On Get, the total duration of the items returned. On Put 
the duration 

* of the existing playlist that is to be replaced with new 
items. 

* NOTE: On Put/ edit range specified by editStartPosition 
for length 

* editDuration must lie entirely within existing playlist. 

Use 

* MsmPlayer .getPlaylist () to get listStartPosition and 
listDuration to 

* determine playlist bounds. 

public long editDuration; 
/** 

* On Get, the startPosition for the entire playlist. On 
Put, the new 

* startPosition for the playlist after edits. 
V 

public long listStartPosition; 
/* * 

* On Get, the duration of the entire list. On Put, ignored 
V 

public long listDuration; 

public Msmltem[] items; 
/* * 

* On Get, the current loop state of the playlist. On Put, 
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if TRUE, the 

* playlist wraps from end->start, start-end. 
V 

public boolean isLoop; 

public MsmPlaylist (long modstamp, boolean isLoop, long 
editStartPosition, 

long editDuration, Msmltemf] items, 
long listStartPosition, long listDuration) 
this .modstamp = modstamp; 
this. isLoop = isLoop; 

this. editStartPosition = editStartPosition; 
this .editDuration = editDuration; 
this. items = items; 

this .listStartcPosition = listStartPosition; 
this. listDuration = listDuration; 

} 

MsmPlaylist (XdrBlock xdr) { 
modstamp - xdr .xdrinMsmTime () ; 
isLoop = xdr .xdrinBoolean ( ) ; 
editStartPosition = xdr .xdrinMsmTime () ; 
editDuration = xdr .xdrinMsmTime () ; 
items = new MsmI tern [xdr .xdr inlnt ()] ; 
for (int i = 0; i < items . length; i++) { 
int itemType = xdr .xdrinlnt ( ) ; 
switch (itemType) { 
case TITLE: 
itemsfi] « new MsmTitleltem (xdr) ; 
break; 
case DEADAIR: 
items [i] = new MsmDeadAirltem (xdr) ; 
break; 

} 

} 

listStartPosition = xdr .xdrinMsmTime () ; 
listDuration = xdr . xdrinMsmTime () ; 

} 

void xdrout (XdrBlock xdr) { 
xdr .xdroutMsmTime (modstamp) ; 
xdr .xdroutBoolean (isLoop) ; 
xdr .xdroutMsmTime (editStartPosition) ; 
xdr .xdroutMsmTime (editDuration) ; 
xdr .xdroutlnt (items. length) ; 
for (int i = 0; i < items . length; i++) { 

if (items(i) instanceof MsmTitleltem) { 



47 



EP 0 803 826 A2 



xdr.xdroutlnt (TITLE) ; 

( (MsmTitleltem) items [i]) .xdrout (xdr) ; 

} else { 

xdr.xdroutlnt (DEADAIR) ; 

( (MsmDeadAirltem) items [i] ) .xdrout (xdr) ; 

} 

xdr .xdroutMsmTime (listStartPosition) ; 
xdr .xdroutMsmTime (listDuration) ; 

} 

public String toStringO { 
return MsmToString.playlistToString (this) ; 

} 

private static final int TITLE = 0; 
private static final int DEADAIR - 1; 
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MsmConncct 

/* 

* 8 ( # ) MsmConnect . j ava 
★ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
★ 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM.Sun.isg.smcjc; 

/** it 

* Connection paramaters . 

* These parameters are passed directly to mf s_str_open ( ) . 
*/ 

public class MsmConnect { 
j * * 

* The transport independent address. 

* + f 

public String destTiAddr; 
j * * 

* The packet encapsulation specifier (eg. MPEG Transport, * 
DSS, etc) . 

*/ 

public String encap; 
/** 

* The bits/second network bandwidth to request. 
*/ 

public int rate; 

public MsmConnect (String destTiAddr, String encap, int rate) 

{ 

this. destTiAddr = destTiAddr; 
this. encap = encap; 
this. rate = rate; 

} 

MsmConnect (XdrBlock xdr) { 
destTiAddr = xdr . xdrinString ( ) ; 
encap = xdr .xdrinString () ; 
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rate - xdr .xdrinlnt () ; 

} 

void xdrout (XdrBlock xdr) { 
xdr.xdroutString(destTiAddr) ; 
xdr.xdroutString(encap) ; 
xdr .xdroutlnt (rate) ; 

} 

public String toStringO { 
return MsmToString.connectToString (this) 

} 
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MsmPlayStatus 

/* 

* @ (#) MsmPlayStatus. java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
★ 

* version 1,0 

* author Christopher Lindblaci 

V 

package COM. Sun. isg. smcjc; 

/** - * 

* MsmPlayStatus indicates the current state of the player. 

* STATE_WAIT indicates that a play command has been given, but 

* that startDate has not arrived. 
*/ 

public class MsmPlayStatus { 
public long pausePosition; 
public long currentDate; 
public long currentPosition; 
public String info; 
public int currentState; 
public int currentSpeed; 
public boolean pausePending; 



MsmPlayStatus (XdrBlock xdr) { 
info = xdr .xdrinString ( ) ; 
pausePending = xdr .xdrinBoolean ( ) ; 
pausePosition = xdr .xdrinMsmTime ( ) ; 
currentState = xdr .xdrinlnt ( ) ; 
currentSpeed = xdr .xdrinlnt () ; 
currentDate = xdr . xdrinMsmTime () ; 
currentPosition = xdr .xdrinMsmTime () ; 

} 



public String toStringO { 
return MsmToString.playStatusToString (this) ; 

} 



public static final 
public static final 
public static final 



int STATE_STOP = 0 
int STATE_WAIT = 1 
int STATE PLAY = 2 
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MsmToString 

/* 

* @ (#) MsmToString. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 



package COM.Sun.isg.smcjc; 
import .java.util.--*/* 

class MsmToString { 

static String sessionToString (MsmSession se) ( 
return "MsmSession" 

+ " [serverHostName=" + se . getServerHostName ( ) 

+ «J«; 

} 

static String playerToString (MsmPlayer pi) { 
byte[] h = pi .getHandle {) ; 

StringBuffer sb = new StringBuf f er (h . length*2) ; 
for (int i = 0; i < h. length; { 
byte b = h[i] ; 

sb. append (Character. forDigit ( (b » 4) & Oxf, 16)); 
sb. append (Character. forDigit( b & Oxf, 16)); 

} 

return "MsmPlayer" 

+ " [serverHostName=" + 
pi . getSession ( ) . getServerHostName ( ) 

+ " handle=" + sb.toString () 
+ "]"; 



private static final String [] rights = 
{ "admin" , "read" / "control" } ; 

private static final String [] ops = { "add" , "remove" } ; 

static String accessRightToString (MsmAccessRight ar) { 
StringBuffer sb = new StringBuf fer {) ; 
for (int i = 0; i < rights . length; i++) { 
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if ({ar. access & (1 « i) ) != 0) { 
if {sb. length () > 0) sb . append (" I ") ; 
sb. append (rights [i] ) ; 

} 

} 

if (sb. length () 0) sb. append ( "none") ; 
String op; 

if (ar.op >= 0 && ar.op < ops. length) op = ops [ar.op]; 
else op = String. valueOf (ar.op) ; 
return "MsmAccessRight" 
+ " [name=" + ar.name 

+ " access=" + sb. toString ( ) 
+ " op=" + op 
+ "]"; 
} - * 

static String connectToString (MsmConnect co) { 
return "MsmConnect" 

+ " [destTiAddr=\"" + co.destTiAddr +»\»» 
+ " encap=\"" + co.encap + M \"" 

+ " rate=" + co.rate 
+ "]"; 



static String deadAirltemToString (MsmDeadAirltem dai) { 
return "MsmDeadAirltem" 

+ " [itemDuration=" + dai . itemDuration 

+ " joinInDuration=" + dai . joinlnDuration 
+ "]"; 

} 

private static final String!] types = { 
"none", "playlist", "playposition" , "playcurdate" } ; 

static String persistenceToString (MsmPersistence pe) { 
String type; 

if (pe.type >= 0 pe.type < types . length) type = 
types [pe. type] ; 

else type = String. valueOf (pe, type) ; 
return "MsmPersistence" 
+ " [type= ,f + type 
+ " 

terminateDate=\" "+dateToString (pe . terminateDate) +"\ " " 
+ "]"; 

} 

static String dateToString (long date) { 
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if (date == MsmPlayer .TIME_MAXTIME) return "never"; 
else return new Date (date/lOOOOOOL) .toStnng () ; 

} 

private static final String [] states = 
{"stop", "wait", "play"}; 

private static final String [] speeds = { 
» S cene_reverse","fastest_rever 5 e","faster_reverse", 'fast_rev 

""""reverse", "slow reverse", "slower.reverse", "slowest reverse", 
"slowest forward" , "slower_f orward", "slow forward , forward. 



"Slowest lorwaiu , oxu»=i_w-. , fnr 

" f ast_f o7ward" , " f aster_f orward" , " f astest_f orward" , scene_f or 
ward" } ; 

static String playStatusToString (MsmPlayStatus ps) { 
ff^ps.currentState >= 0 && ps.currentState < states .length) 

1 state = states [ps.currentState] ; 

} else state = String. valueOf (ps .currentState) ; 

if"ps\SrrentSpeed >= 0 && ps.currentSpeed < speeds . length) 

* speed = speeds [ps. currentSpeed] ; 

} else speed = String. valueOf (ps .currentSpeed) ; 
return "MsmPlayStatus" 

+ "[info=\"" + ps.info +"\"" 

+ " pausePending=" + ps .pausePending 
+ " pausePosition=" + ps .pausePosition 
+ " currentState=" + state 
+ " currentSpeed=" + speed 

+ " currentDate=\"" + dateToString (ps .currentDate) + 



II ^ II II 



+ " currentPosition=" + ps .currentPosition 



} 

static String playlistToString (MsmPlaylist pi) { 
StringBuffer sb = new StringBuf f er () ; 
if (pi. items != null) { 

for (int i = 0; i < pi . items . length; i++) { 
if (i != 0) sb . append (" , ") ; 
sb. append (pi. items [i] .toStringO ) ; 

} 

} 

return "MsmPlaylist" 
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+ " [modstamp=\"" + dateToString (pi .mods tamp) + 
+ " isLoop=" + pl.isLoop 

+ " editStartPosition=" + pl.editStartPosition 

+ " editDuration=" + pi . editDuration 

+ " items=[" + sb.toStringO + "]" 

+ " listStartPosition=" + pi . listStartPosition 

+ " listDuration=" + pi . listDuration 

+ "]"; 



static String titleToString (MsmTitle ti) { 
StringBuffer sb = new StringBuf f er ( ) ; 
if (ti . speedScale != null) ( 

for (int i = 0; i < ti . speedScale . length; i++) 
if (i !=<p) sb.append(", ") ; 
sb. append (ti. speedScale [i] ) ; 

} 

} 

return "MsmTitle" 

+ " [name^"" + ti.name + "\"" 

+ " speedScale=[" + sb.toStringO + "J" 

+ " maxBitRate=" + ti .maxBitRate 

+ " totalPlayDuration=" + ti . totalPlayDuration 

+ " format=\"" + ti. format + "\ nn 

+ ")"; 



static String titleltemToString (MsmTitlel tern ti) { 
return "MsmTitlel tern" 

+ " [titleName=\" M + ti.titleName + "V" 
+ 11 itemDuration=" + ti . itemDuration 
+ " startOffset=" + ti . startOf f set 
+ " playDuration=" + ti .playDuration 
+ " joinInDuration=" + ti . joinlnDuration 

+ " isTimeLocked=" + ti. isTimeLocked 

+ " playClosestSpeed=" + ti .playClosestSpeed 
+ " maxBitRate=" + ti .maxBitRate 

+ "]"; 
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Msmltem 

/* 

* (? (#)MsmItem. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved 

* 

* version 1.0 

* author Christopher Lindblad 
+ 

*/ 

package COM. Sun. isg . smcjc; 
public abstract class Msmltem { 

* The number of milliseconds allocated to this item. 
*/ 

public long itemDuration; 
/** 

* Time of initial play that may be sacrificed to absorb 

previous schedule 

* slips. Silently limited to itemDuration. If 

TIME_CURRENT, 

* itemDuration is used. 

*/ 

public long joinlnDuration; 

} 
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MsmTitleltem 

/* 

* @ (#)MsmTitleItem. java 
★ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
+ 

* version 1.0 

* author Christopher Lindblad 

V 

package COM.Sun.isg. smcjc; 

/* - * ■ 

* A playlist title item. 
*/ 

public class MsmTitleltem extends Msmltem { 
/** 

* The number of milliseconds into title where play should 
begin. It is 

* illegal for this to be greater than the total play time 
the title. 

*/ 

public long startOffset; 
/** 

* The number of milliseconds of title to play within this 

item. 

* Values less than itemDuration allow some pad for absorbi 
admission 

* delays (and the play truncation that would occur) , but 
should admission 

* delay be zero, dead air would occur for the remainder of 
the item. It 

* is illegal for playDuration to be greater than 
itemDuration or for 

* playDuration + startOffset to be greater than the total 
play time of 

* the title. If TIME_CURRENT, the min of itemDuration and 
total play time 

* minus startOffset is used. 

*/ 

public long playDuration; 
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* The file pathname for title. 
*/ 

public String titleName; 



/ **ignored on MsmPlayer. setPlaylist . Returns max bit rate of 

title on 

* MsmPlayer. getPlaylist. 

*/ 

public int maxBitRate; 

7 **if true, terminate play after itemDuration seconds (even 

if admission . , . ... , 

* delays have paused schedule to slip and title has not 

C ° Itipl ! t faise/always play itemDuration seconds of title, allow 

schedule to 

* slip if necessary. 

*/ 

public boolean isTimeLocked; 

7 **if true, plays closest available speed in same direction 
if re ^sted is nQt available . search for closest is proceeds 
towardS p normal ati ^ ^ ^ ^ . f presentation 

"direction, is not available. If false, play of title is 

skipped if . 

* appropriate speed is not available. 

*' 

public boolean playClosestSpeed; 

public MsmTitleltem (String titleName, long itemDuration, long 

startOffset, . . T ^ 

long playDuration, long jomlnDuration, 
boolean isTimeLocked, boolean playClosestSpeed, 
int maxBitRate) { 

this. titleName = titleName; 

this. itemDuration = itemDuration; 

this. startOffset = startOffset; 

this. playDuration = playDuration; 

this.joinlnDuration = joinlnDuration; 

this. isTimeLocked « isTimeLocked; 

this. playClosestSpeed = playClosestSpeed; 
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this .maxBitRate = maxBitRate; 

} 

MsmTitleItem(XdrBlock xdr) { 
titleName = xdr .xdrinString ( ) ; 
iteiaDuration = xdr .xdrinMsmTime () ; 
startOffset = xdr .xdrinMsmTime () ; 
playDuration = xdr .xdrinMsmTime () ; 
joinlnDuration = xdr .xdrinMsmTime () ; 
isTimeLocked = xdr .xdrinBoolean() ; 
playClosestSpeed = xdr.xdrinBooleanO ; 
maxBitRate = xdr .xdrinlnt ( ) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr .xdroutString (titleName) ; 
xdr .xdroutMsmTime (itemDuration) ; 
xdr .xdroutMsmTime (startOffset) ; 
xdr.xdroutMsmTime (playDuration) ; 
xdr.xdroutMsmTime (joinlnDuration) ; 
xdr . xdroutBoolean ( isTimeLocked) / 
xdr .xdroutBoolean (playClosestSpeed) ; 
xdr .xdrout Int (maxBitRate) ; 

} 

public String toStringO ( 
return MsmToString . ti tlel temToString ( this ) 

} 
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MsmPeadAirltem 

/* 

* @ (#)MsmDeadAirItem. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved- 
* 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM.Sun.isg.smcjc; 

public class MsmDeadAirltem extends Msmltem { 

public MsmDeadAirltemdong itemDuration, long joinlnDuration) 

{ this. itemDuration = itemDuration; 

this. joinlnDuration = joinlnDuration; 

) 

MsmDeadAirItem(XdrBlock xdr) { 
itemDuration = xdr .xdrinMsmTime 0 ; 
joinlnDuration = xdr .xdrinMsmTime () ; 

} 

void xdrout (XdrBlock xdr) { 
xdr .xdroutMsmTime (itemDuration) ; 
xdr . xdroutMsmTime ( j oinlnDurat ion ) ; 

} 

public String toStringO { 
return MsmToString.deadAirltemToString (this) ; 

) 
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MsmExceotion 

/* 

* @ (#) MsmException. java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 
★ 

*/ 

package COM.Sun.isg. smcjc; 

import java.io.*; * 
/* * 

* Signals that an Media Stream Manager exception has occurred. 
*/ 

public class MsmException extends IOException { 
/* * 

* Constructs an MsmException with no detail message. 

* A detail message is a String that describes this 
particular exception. 

*/ 

MsmException ( ) { 
super ( ) ; 

} 

/** 

* Constructs an MsmException with the specified detail 
message. 

* A detail message is a String that describes this 
particular exception. 

* @param s the detail message 
*/ 

MsmException (String s) ( 
super (s) ; 

} 

MsmException (int proc, String msg) { 
super(((proc >= 0 && proc < procNames . length) ? 

procNames [procl : Integer . toString (proc) ) 
+ ": " + 
msg) ; 

} 
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+ ... .. + 



((err >= 0 && err < errNames . length) ? 
errNames[err] : Integer. toS.tring (err) )) ; 



private static final String [] procNames - { 
"null", 

"server authtype" , 
"player create", 
"player delete", 
"player list", 
"player access* set", 
"player access get", 
"player persistence set", 
"player persistence get", 
"player playlist set", 
"player playlist get", 
"player connect set", 
"player connect get", 
"player play", 
"player pause", 
"player resume", 
"player play status", 
"title status", 
}; 

private static final String [] errNames = I 
"success", /* 0 */ 

"failed", /* 1 * / 

"badarg", /* 2 *' 

"no mem", /* 3 *' 

"no netname", /* 4 */ 

"des auth failed", /* 5 */ 



"kerb auth failed", 
"no such player", 
"old modstamp", 
"item overlap", 
"bad speed", 
"bad start date", 
"not connected", 
"bad pause position", 
"play active", 
"bad file name", / 
"bad mfs file", 



/+ 6 */ 
/* 7 */ 
/* 8 */ 
/* 9 */ 
/* 10 */ 
/* 11 */ 
/* 12 */ 
/* 13 */ 
/* 14 */ 



/* 15 */ 

/* 16 */ 
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"bad 


file type", 


/* 


17 */ 




"info too long", 


/* 


18 */ 




"auth failed", 


/* 


19 */ 




"bad position", 




/* 20 


*/ 


"kerberos unsupported" , 


, /* 21 


*/ 


"bad 


credentials", 


/* 


22 */ 




"insufficient authorization", 


/* 


"bad 


access op", 


/* 


24 */ 




"bad 


access type", 


/* 


25 */ 




"bad 


persist type", 


/* 


26 * / 




"bad 


time arg", 




/*' 27 


*/ 


"bad 


start position 


if 

/ 


/* 28 


+ / 


"bad 


duration", 




/* 29 


* / 

f 


"bad 


start offset", 


/* 


30 */ 




"bad 


edit statt pos 


ft 

/ 


/* 31 


*/ 


"bad 


edit duration" 


/ 


/* 32 


*/ 


"bad 


list start pos 


if 

/ 


/* 33 


/ 


"bad 


item duration" 


/ 


/* 34 


* / 


"bad 


join in duration", 


/* 35 


+ / 


"bad 


play duration" 


/ 


/* 36 


*/ 


"bad 


item type", 


/* 


37 */ 




"bad 


title type", 


/* 


38 */ 




"no such file", 




/* 39 


*/ 


"bad 


lut file", 




/* 40 


*/ 


"bad 


mfs fs", 


/* 


41 */ 




"toe 


syntax", 


/* 


42 */ 




"toe 


eof", 


/* 


43 */ 




"toe 


bad char", 




/* 44 


+ / 


"no normal speed", 


/* 


45 */ 




"dup 


speeds", 


/* 


46 */ 




"bad 


file len", 




/* 47 


*/ 


"toe 


incomplete", 


/* 


48 */ 




"toe 


can't map", 


/* 


49 */ 




"toe 


bad filesize", 


/* 


50 */ 




"toe 


bad index", 


/* 


51 */ 




"too 
}; 


low connect rate", 


/* 52 


*/ 
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XdrBlock 

/* 

5 * @ (#) XdrBlock. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1-0 

10 * author Christopher Lindblad 
★ 

package COM . Sun . i sg . smc j c ; 

15 

import java.io.*; *■ 
import java.net.*; 

/** 

20 * Used to manipulate ONC RPC calls and replies. 
*/ 

class XdrBlock { 
byteU buf; 
int ptr; 

25 

/* 

* Create a new empty block. 

* @param size The size of the block. 

* / 

30 ' 

public XdrBlock (int size) { 
buf = new byte [size]; 

} 

35 /* 

* Create a new empty block. 
*/ 

public XdrBlock () { 
this (256) ; 

40 } 

/* 

* Create a new block and initialize it with a call header. 

* @param prog The RPC program number. 
45 * @param vers The RPC version number. 

* Gparam proc The RPC procedure number. 

* Greturn The xid generated. 
*/ 
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public XdrBlock(int prog, int vers, int proc) { 
thisO; 

xdroutCallHeader (prog, vers, proc) ; 

) 

/** 

* Create a new block and receive it from an Input Stream. 

* @param is The InputStream from which to receive the block 

* @exception IOException If an 10 error has occurred. 
V 

public XdrBlock (InputStream is) throws IOException { 
synchronized (is) { 
int hdr; 
do { 

hdr - readByte (is) « 24; 
hdr 1= readByte (is) « 16; 
hdr |= readByte (is) « 8; 
hdr 1= readByte (is) 
int start; 

int count = hdr & 0x7fffffff; 
if (buf == null) { 
start = 0; 

buf = new byte [count]; 
} else { 

start = buf. length; 

byte[] tmp = new byte [start + count]; 
System. arraycopy (buf , 0, tmp, 0, start); 
buf = tmp; 

> 

while (count > 0) { 

int done = is.read(buf, start/ count); 

if (done < 0) throw new IOException ( "end of file") 

start += done; 

count -= done; 

} 

) while ((hdr & 0x80000000) == 0) ; 

} 

} 

private int readByte (InputStream is) throws IOException { 
int result = is.readO; 

if (result < 0) throw new IOException ( "end of file" ); 
return result; 

} 

/** 

* Send the block to an output stream. 
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@Daram is The OutputStream ro which to send the block. 
SexcStion lOException If an 10 error has occurred. 

public synchronized void send (OutputStream os) throws 

lOException { ^„ nr > nn « n 
int hdr = ptr I 0x80000000; 
synchronized (os) { 

os.write( (hdr » 24) & Oxff); 

os. write ((hdr » 16) & Oxff); 

os. write ( (hdr » 8) & Oxff); 

os. write ( (hdr ) & Oxff ) ; 

os. write (buf, 0, ptr); 

if (os instanceof Buf f eredOutputStreara) I 
( (BufferedOutputStream)os) . flush () ; 

} 

} 

} 

'"input a fixed-length array of bytes from the block. 

* eparam len The lenght of the array. 

* Sreturn The byte array. 

public synchronized byteU xdrinBytes (int len] 
byte[] result = new byte [len]; 
System. arraycopy (buf, ptr, result, 0, len) ; 
ptr = (ptr + len + 3) & -4; 
return result; 

} 

'"input a variable-length array of bytes from the block. 

* @return The byte array. 
*/ 

public synchronized byte [] xdrinBytes {) { 
return xdrinBytes (xdrinlnt ( ) ) ; 

} 

/** 

* Input an int from the block. 

* @return The int. 
*/ 

public synchronized int xdrinlnt 0 { 
int result; 

result = (buf [ptr ] & Oxff) « 24; 
result 1= (buf [ptr + 1] & Oxff) « 16; 
result 1= (buf [ptr + 2] & Oxff) « 8; 



{ 
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result |= (buflptr + 3] & Oxff ) ; 
ptr += 4; 
return result; 

} 

/** 

* Input an boolean from the block. 

* @return The boolean. 
V 

public boolean xdrinBoolean { ) { 
return xdrinlnt() != 0; 

} 

/** 

* Input a String from the block. 

* @ return The String. 
*/ 

public String xdrinString ( } { 
return new String (xdrinBytes () , 0) ; 

} 

/** 

* Input a Media Stream Manager Time value 
*/ 

public synchronized long xdrinMsmTime ( ) { 
long sec = xdrinlntO; 
long nsec = xdrinlntO; 
if (sec == nsec sec < 0) return sec- 
return sec*1000000000L + nsec; 

} 

/** 

* Output a fixed-length array of bytes to the block. 

* @param val The array to output. 

* @param len The length of the array to output. 
V 

public synchronized void xdroutBytes (byte [ ] val, int len) 
int nxt = (ptr + len + 3) & -4; 
if (nxt > buf. length) grow(nxt); 
System. arraycopy (val, 0, buf, ptr, len); 
ptr = nxt; 

} 

/** 

* Output a variable-length array of bytes to the block. 

* @param val The array to output. 
V 
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public synchronized void xdroutBytes (byte tl val) t 
int len = val. length; 
xdroutlnt (len) ; 
xdroutBytes (val, len); 

} 

/** 

* Output an int to the block. 

* @param val The int to output. 

public synchronized void xdroutlnt (int val) ( 
int nxt = ptr +4; 
if (nxt > buf. length) grow(nxt); 
buf [ptr ] = (byte) {(val » 24) & Oxff , 
but ptr + H (byte) ((val » 16) s Oxff 
buf ptr + 2] = (byte) ((val » 8 & Oxff 
buf [ptr + 3] = (byte) ((val ) & Oxff), 

ptr = nxt; 

} 

/** 

* Output an boolean to the block. 

* Sparam val The boolean to output. 

public void xdroutBoolean (boolean val) I 
xdroutlnt (val? 1:0) ; 

} 

/** 

* Output a String to the block. 

+ @param val The String to output. 

*/ 

public void xdroutString (String val) { 
int len = val . length ( ) ; 
byteU tmp = new byte[len]; 
val.getBytes(0, len, trap, 0) ; 
xdroutBytes (tmp) ; 

} 

/** 

* Output a Media Stream Manager Time value 

* @param val The time to output. 

public synchronized void xdroutMsmTime (long val) 

if (val < 0) { 

xdroutlnt ( (int) val) ; 
xdroutlnt ( (int) val) ; 
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} else { 

xdroutlnt ( (int) (val/lOOOOOOOOOL) ) ; 
xdroutlnt ( (int) ( val%1000000000L) ) ; 

} 

} 

private void grow (int needed) { 
int len = buf . length*2; 
while (len < needed) len *= 2; 
byte[] tmp = new byte [len]; 

System. arraycopy (buf , 0, tmp, 0, buf. length); 
buf = tmp; 

} 

/** * 

* Output a RPC Call header to the block. 

* @param prog The RPC program number. 

* @param vers The RPC version number. 

* @param proc The RPC procedure number. 
*/ 

public synchronized void xdroutCallHeader (int prog, 

int proc) { 

xdroutlnt (genXid ( ) ) ; 
xdroutlnt (CALL) ; 
xdroutlnt (RPCVERS) ; 
xdroutlnt (prog) ; 
xdroutlnt (vers) ; 
xdroutlnt (proc) ; 
xdroutlnt (AUTHJJNIX) ; 
xdroutBytes (cred ( ) ) ; 
xdroutlnt (AUTH_NULL) ; 
xdroutBytes (verf () ) ; 

} 

public synchronized int callXidO { 
int tmp = ptr; 
ptr - 0; 

int result = xdrinlntO; 
ptr = tmp; 
return result; 

} 

public synchronized int callProcO { 
int tmp = ptr; 
ptr = 20; 

int result = xdrinlntO; 
ptr = tmp; 
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10 



30 



40 



50 



return result; 

} 



private static int lastXid = 0; 

private synchronized static int genXidO { 
if (lastXid ! = 0) lastXid +=1; rtr ^ x 
else fasWid = Unt)(Math.random() * 2147483648 . 0D) ; 

return lastXid; 

) 



private static byte[] lastCred; 

, 5 private synchronized static byte I ] cred() { 

if (lastCred v n ull > t ' . ,. 
YHrRiock xdr = new XdrBlocM); 

xdr xd?ouUnt ( (int) (System. currentTimeMillis () /1000L) ) 

frfhost^inetAdclr.ss.getLocalHost., .gtHutft*.!) » 

catch (UnknownHostException e) host - . - - , 
xdr.xdroutString (host) ; 
int uid; 

« Integer. p£l^ 

catch (NumberFormatException e) uid - u, 

xdr.xdroutlnt (uid) ; 

int gid; 



try gid - . _ M . . 

Integer.parseInt(System.getProperty("user.gid_)); 

catch (NumberFormatException e) gid - u, 



xdr.xdroutlnt (gid) ; 
xdr. xdr out Int (0) ; // no gids 
lastCred = new byte [xdr. ptr] ; 
35 system. arraycopy (xdr. buf, 0, lastCred, 0, xdr. ptr), 

} 

return lastCred; 

} 



private static byte [] lastVerf; 



private synchronized static byte[] verf 0 { 
if (lastVerf == null) I 
45 lastVerf = new byte[0]; 

} 

return lastVerf; 

} 
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/** 

* Input a RPC reply header from the block. 

* @parain xid The expected xid. 

* ^exception IOException If an error has occurred. 
V 

public synchronized void xdrinReplyHeader (int xid) throws 
IOException { 

int replyXid = xdrinlntO; 
if (replyXid != xid) { 

throw new IOException ( 
"rpc xid mismatch: " + 

"expected " + xid + " but got " + replyXid) ; 

} 

int msgType = xdrinlntO; 
if (msgType REPLY) { 

throw new IOException ( 
"rpc msg type mismatch: " + 

" expected " + REPLY + " but got " + msgType); 

} 

int replyStat = xdrinlntO; 
switch (replyStat) { 
case MSG_ACCEPTED: 

int verfType = xdrinlntO; 
byte[] verf = xdrinBytes ( ) ; 
int acceptStat = xdrinlntO; 
switch (acceptStat) { 
case SUCCESS: 
return; 
case PROGJJNAVAIL: 
throw new IOException ( 
"rpc accepted: " + 
"remote hasn't exported program"); 
case PROG_MISMATCH: 
int low = xdrinlntO; 
int high = xdrinlntO; 
throw new IOException ( 
"rpc accepted: " + 

"version mismatch low=" + low + " high= M + high) 
case PROC_UNAVAIL: 
throw new IOException ( 

"rpc accepted: " + 

"program can't support procedure"); 
case GARBAGE_ARGS : 
throw new IOException { 

"rpc accepted: " + 

"procedure can't decode params"); 
default : 
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throw new IOException( 
"rpc accepted: " + 
"unknown status: " + acceptStat) , 

} 

e MSG_DENIED: 
int rejectStat = xdrinlntO; 
switch (rejectStat) { 
case RPC_MISMATCH: 
int low = xdrinlntO; 
int high = xdrinlntO; 
throw new IOException ( 
"rpc rejected: " + 

"version mismatch low=" + low + high= 
case AUTH_ERROR: 
int authStat = xdrinlntO; 
switch (authStat) { 
case AUTH_BADCRED: 

throw new IOException ( 
"rpc rejected: " + 
"remote can't authenticate caller: 
"bad credentials (seal broken)"}; 
case AUTH_RE JECTEDCRED : 

throw new IOException ( 
"rpc rejected: " + 
"remote can't authenticate caller: 
"client must begin new session"); 
case AUTH_BADVERF: 

throw new IOException ( 
"rpc rejected: " + 
"remote can't authenticate caller: 
"bad verifier (seal broken)"); 
case AUTH_RE JECTEDVERF : 

throw new IOException ( 
"rpc rejected: " + 
"remote can't authenticate caller: 
"verifier expired or replayed"); 
case AUTH_TOOWEAK : 

throw new IOException ( 
"rpc rejected: " + , , .. 

"remote can't authenticate caller: 
"rejected for security reasons"); 

default: 

throw new IOException! 
"rpc rejected: " + n 
"remote can't authenticate caller: 
"unknown status: " + authStat); 

} 
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default: 
throw new IOException( 
"rpc rejected: " + 
"unknown status: " + rejectStat); 

} 

default: 

throw new IOException ( "unknown rpc reply status: " + 
replyStat) ; 
) 

} 

/* 

* Blow up if ptr hasn't reached the end of the block. 
V 

public void donj&O throws IOException { 
if (ptr != buf. length) { 
throw new IOException ( 
(buf . length-ptr) + " extra bytes of data remaining in 

reply" ) ; 
} 

} 

/* 

* Provisions for authentication of caller to service and 
vice-versa are 

* provided as a part of the RPC protocol. The call message 
has two 

* authentication fields, the credentials and verifier. The 

reply 

* message has one authentication field, the response 
verifier. The RPC 

* protocol specification defines all three fields to be the 
following 

* opaque type (in the external Data Representation (XDR) 
language [ 9] ) : 

V 

private static final int AUTH_NULL = 0; 

private static final int AUTH_UNIX = 1; 

private static final int AUTH_SHORT = 2; 

private static final int AUTH_DES = 3; 

/* 

* RPC Message protocol version 2 
V 

private static final int RPCVERS = 2; 
private static final int CALL = 0; 
private static final int REPLY = 1; 
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f * A reply to a call message can take on two forms: The 

message was 

* either accepted or rejected. 

private static final int MSG_ACCEPTED = 0; 
private static final int MSG_DENIED = 1; 

'* Given that a call message was accepted, the following 
the s ^ a ^ s an attempt to C aii a remote procedure. 
*/ 

private static final int SUCCESS = 0; 

private static .final int PROG_UNAVAIL = 1; 
private static final int PROG_MISMATCH = 2; 
private static final int PROC_UNAVAIL = 3; 
private static final int GARBAGE_ARGS = 4; 

* Reasons why a call message was rejected: 

private static final int RPCJilSMATCH = 0; 
private static final int AUTHERROR = 1; 

/ 



* Why authentication failed: 
*/ 

private static final int AUTH_ 

private static final int AUTH_ 

private static final int AUTH_ 

private static final int AUTH_ 

private static final int AUTH_ 



BADCRED = 1 

"REJECTEDCRED = 2 
BADVERF = 3 

REJECTEDVERF == 4 
"TOOWEAK = ^ 



} 



74 



EP 0 803 826 A2 



PortMapper 

/* 

* @ ( # ) PortMapper . j ava 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM.Sun.isg.smcjc; 

import java.io.*; * 
import java.net.*; 

/** 

* Interface to the ONC port mapper. 
*/ 

class PortMapper { 

private Socket socket; 
private InputStream is; 
private Outputs tream os; 

j <k * 

* Create a port mapper client. 

* @param host The server for which we want to know the port 
mappings . 

* Gexception IOException If there is an error. 
*/ 

public PortMapper (String host) throws IOException { 
socket - new Socket (host, PMAP_PORT) ; 

is = new Buf feredlnputStream (socket . getlnputstream( ) ) ; 
os = new Buf f eredOutputStream (socket. getOutputStream ( ) ) ; 

} 

I + + 

* Get the port number for a particular ONC service. 

* @param prog The RPC program number. 

* @param vers The RPC version number. 

* @param prot Either IPPROTOJTCP or IPPR0T0_UDP. 

* @return The port number for the service. 

* @exception IOException If there is an error. 
*/ 

public synchronized int getPort(int prog, int vers, int prot) 
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throws IOException { 

XdrBlock call = new XdrBlock!) ; 

call .xdroutCallHeader (PMAP_PROG, PMAP_VERS, 

PMAPPROC_GETPORT) ; 

call . xdroutlnt (prog) ; 
call .xdroutlnt (vers) ; 
call. xdroutlnt (prot) ; 
call. xdroutlnt (0) ; 
call. send (os) ; 

XdrBlock reply = new XdrBlock (is) ; 
reply. xdrinReplyHeader (call. callXidO ) ; 

int result = reply. xdrinlnt () ; 
reply. done () ; 
return result; 

} 

/** 

* Closes the port mapper. 

public synchronized void close 0 throws lOExcept 
socket. close () ; 



static final int IPPROTO_TCP = 6; 
static final int IPPROTOJJDP = 17; 

private static final int PMAP_PROG = 100000; 
private static final int PMAP_VERS = 2; 
private static final int PMAP_P0RT = 111; 

private static final int PMAPPROC_NULL = 0 
private static final int PMAPPROC_SET = 1 
private static final int PMAPPROCJJNSET = 2 
private static final int PMAPPROC_GETPORT = 3 
private static final int PMAPPROC_DUMP = 4 
private static final int PMAPPROC_CALLIT = 5 
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Decoder 

/* 

* @ (#) Decoder . java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 



package COM. Sun. isg.smcjc; 

import java.awt.*; * 
import java.io.*; 

public class Decoder extends Panel { 
private Decoderlmpl impl; 

public Decoder {) { 
setLayout (new BorderLayout () ) ; 

} 

public synchronized void init (String format/ Image img, String 
host,int port, String ATM) 
throws IOException { 
try { 

Class implClass = Class. forName (implClassName (format) } ; 
if (impl == null II impl .getClass ( ) != implClass) { 
removeAll () ; 

impl = (Decoderlmpl) implClass -newlnstance () ; 
add ("Center", impl) ; 

} 

impl .init (format, img, host, port, ATM) ; 
} catch (ClassNotFoundException e) { 

throw new IOException(e.toString() ) ; 
} catch (IllegalAccessException e) { 

throw new IOException (e.toString ()) ; 
} catch (InstantiationException e) { 

throw new IOException (e.toString {)) ; 

} 



public synchronized void paint (Graphics g) { 
if (impl != null) super .paint (g) ; 
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else { 

Rectangle b = bounds ( ) ; 

g.setColor (getBackgroundO ) ; 

g.fill3DRect (0, 0/ b. width, b. height, true); 

} 

} 

public synchronized void stopO throws IOException { 
if (impl != null) impl.stopO; 

} 

public synchronized void pause () throws IOException { 
if (impl != null) impl .pause 0 ; 

} 

public synchronized void playO throws IOException { 
if (impl != null) impl.playO; 

} 

public synchronized void flush () throws IOException { 
if (impl != null) impl . flush () ; 

> 

public synchronized String destTiAddrO throws IOException { 
if (impl != null) return impl .destTiAddr ( ) ; 
return ""; 

} 

public synchronized String encapO throws IOException { 
if (impl != null) return impl.encapO ; 
return ""; 

} 

j + * 

* A hacky implementation factory 
V 

private static String implClassName (String format) throws, 
IOException { 

String osArch = System. getProperty ("os . arch", "?os.arch"); 
String osName = System. getProperty ("os. name", "?os .name") ; 
String osVersion = System. getProperty ("os. version", 
■^os .version") ; 

String spec = format + " " + osArch + " " + osName + " " + 
osVersion; 

if (format. equals ("MPEG1SYS" ) ) { 

if (osName. equals ("Solaris") II osName . equals ( "SunOS" ) ) 

{ 
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if (osArch. equals < "spare") ) { 

return "COM. Sun. isg . smeje .MpxDecoderlmpl"; 

} 

] 

} 

throw new IOException ( "no decoder for " + spec); 

} 



Decoderlmpl 
/* 

* @ (#) Decoderlmpl -java 
★ 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 
■* 

* version 1.0 

* author Christopher Lindblad 

+ / 

package COM. Sun. isg.smcjc; 

import java.awt.*; * 
import java.io.*; 

abstract class Decoderlmpl extends Canvas { 

public abstract void init (String format/ Image img, String 
host, int port, String ATM) throws IOException; 

public abstract void stop() throws IOException; 

public abstract void pause () throws IOException; 

public abstract void playO throws IOException; 

public abstract void flush () throws IOException; 

public abstract String destTiAddr() throws IOException; 

public abstract String encapO throws IOException; 
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MpxDecoderlmpl 

/* 

* @ (#) MpxDecoderlmpl. java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved 
* 

* version 1.0 

* author Christopher Lindblad 
* 

V 

package COM*Sun.isg.smcjc; 

import j ava. applet ** ; 
import java.io.*; 
import java.awt.*; 
import j ava . net . * ; 

class MpxDecoderlmpl extends Decoderlmpl implements Runnable 
private String format; 
private String host; 
private int port; 
private int portO; 
private Image img; 
private long f adeTimeMillis; 
private DatagramSocket ctrlSckt; 
private Thread thread; 
private DatagramPacket ctrlPckt; 
private File logFile; 
private float luminance = 1.0F; 
private int dataPort; 
private int scale = 1; 
private int state=STOP; 
private boolean multi=false; 
private boolean ATM=false; 
private String ATMs=null; 

public MpxDecoderlmpl ( ) { 
super ( ) ; 

> 

public synchronized void init (String format, Image img, 
String host, int port, String ATMs) 
throws IOException { 

this. format - format; 
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this.img = img; 
ATM=(ATMs!=null) ; 

this ,port=port; 

this*host=host; 

if ((port— 1)&&{! ATM)) { 
dataPort = genLocalPort () ; 

}else{ 

dataPort * port; 
port0= genLocalPort () ; 
mult i= ! ATM; 

if (ATM) this. ATMs = ATMs; 

} 

ctrlPckt = new DatagramPacket ( 
new 

byte [128] , 128, Inet^ddress .getLocalHost {) , genLocalPort ( ) ) ; 
ctrlWord(0, 0x00000001); // sync 
ctrlWordd, 0x00000002); // sync 
ctrlWord(2, 0x00000003); // sync 
ctrlWord(3, 0x00000004); // sync 
ctrlWord(4, OxaaaaOOOl); // version = 1 
ctrlWord(5, OxbbbbOOOl); // channel = 1 
CtrlWordU, 0x00000000); // sequence = 0 
ctrlWord(7, OxccccOOOO) ; // flags = 0 

ctrlWord(8, OxddddOOOl); // type = 1 

} 

public Dimension minimumSize ( ) { 
return new Dimension (WIDTH, HEIGHT); 

} 

public synchronized Dimension preferredSize ( ) { 
Dimension dim = new Dimension (WIDTH*scale, HEIGHT*scale) ; 
return dim; 

} 

public synchronized void layout () { 
Rectangle b = bounds (); 

double xscale = (double) b. width/ (double) WIDTH; 
double yscale = (double) b. height/ (double) HEIGHT; 
int scale = (int) ( (xscale + yscale) / 2.0 + 0.25); 
if (scale < 1) scale = 1; 
if (scale > 3) scale = 3; 
if (scale != this. scale) ( 
this. scale = scale; 

if (state == PAUSE || state == PLAY) updateVideoMode ( ) ; 

} 

) 
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public synchronized void paint (Graphics g) { 
Dimension ps = pref erredSize () ; 
g . setColor (getBackground ( ) ) ; 

g. f ill3DRect (0, 0, ps. width, ps. height, true); 
if (img != null) g.drawlmage (img, 0, 0, ps. width, ps. height, 
this) ; 
} 

public synchronized void stopO throws IOException { 
if (state == PAUSE I I state == PLAY) { 

if (multil I ATM) { 

StringBuffer sc= new StringBuf fer () ; 

sc. append ("kloop "); 
System. out .println(sc.toString() ) ; 

StringU cmdarray0= new String[3]; 

cmdarray0[0] - "/bin/sh"; 

cmdarray0[l] = "-c"; 

cmdarrayO [2] = sc . toString () ; 

try Runtime. getRuntime () . exec (cmdarrayO) ; 

catch (SecurityException e) 
System . out. println ("Exec="+exec ( cmdarrayO [2] ) ) ; 
} 

ctrlWord(9, MCMD_EXIT) ; 

ctrlSckt.send(ctrlPckt) ; 
ctrlSckt . close ( 5 ; 
ctrlSckt = null; 
state = STOP; 
try { 

if (logFile. length (> == 0) logFile. delete () ; 
} catch (SecurityException e) { 
String cmd - "/bin/rm -f "+logFile . getPath ( ) ; 
try Runtime . getRuntime () .exec (cmd) ; 
catch (SecurityException f) exec (cmd); 

} 

} 

} 

public synchronized void pause () throws IOException { 
if (state == PLAY) { 

ctrlWord(9 / MCMD_PLAYCTR) ; // identifier 

ctrlWorddO, PCJPAUSE) ; // action 

ctrlWorddl, Float . f loatToIntBits ( 1 . OF) > ; // speed 
ctrlSckt. send(ctrlPckt) ; 
state = PAUSE; 

} 
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public synchronized void playO throws IOException { 
if (state == PAUSE) { 

ctrlWordO, MCMD_PLAYCTR) ; // identifier 

ctrlWord(10, PC_PLAY) ; // action 
ctrlWordUl, Float. floatToIntBits (1 .OF) ) ; // speed 
ctrlSckt.send(ctrlPckt) ; 
state = PLAY; 
} else if (state == STOP) { 

StringBuffer sb = new StringBuf f er ( ) ; 
sb. append ("exec rapx"); 
if (Smulti) { 

if (!ATM){ 

sfcfc. append (" -fn udp, lp, "); 
sb - append (dataPort) ; 
}else{ 

sb. append (" -fn udp, lp, "); 
sb* append (portO) ; 
} 

)else{ 

sb. append (" -fn udp,lp,"); 
sb. append (port 0) ; 
} 

sb. append (" -xn udp, lp, " ); 
sb. append (ctrlPckt . getPort () ) ; 
sb. append ( ,r -u 2") ; 
sb. append {" -v ") ; 

int depth = getColorHodel 0 . getPixelSize 0 ; 
if (depth ==1) { 

sb. append ("mono") ; 
} else { 

sb. append ("col") ; 

sb. append (depth) ; 

if (depth == 24 && scale > 1) sb. append ("B" ) ; 

} 

sb. append (", ") ; 

sb. append (scale) ; 

sb. append (" -w " ) ; 

sb . append ( windowld ( ) ) ; 

sb.append(" </dev/null") ; 

sb. append (" >") ; 
System.out .print In (sb. toStringO ) ; 

logFile = new 
File {"/tmp/mpx. "+Systeia.currentTimeMillis () ) ; 

sb. append (logFile. getPathO ) ; 

sb. append {" 2>&1") ; 
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String!] cmdarray - new String[3]; 

cmdarray [0] = "/bin/sh"; 

cmdarray [1] = "-c"; 

cmdarray[2] - sb. toString () ; 

try Runtime . getRuntime ( ) . exec (cmdarray) ; 

catch (SecurityException e) exec (cmdarray [2] ) ; 

ctrlSckt = new DatagramSocket ( ) ; 

state = PLAY; 

if (ATM) { _ #% 

StringBuffer sc= new StringBuf fer () ; 

sc. append ("loop a ") ; 

sc. append (dataPort+" ") ; 

sc. append (port 0+" >sasa &"); 
System. out. println (sc. toString () ) ; 

String[]. cmdarrayO= new String[3j; 
cmdarrayO [0] - "/bin/sh"; 
cmdarrayO[l] = "-c"; 
cmdarray0[2] = sc. toString () ; 
try Runtime.getRuntimeO .exec (cmdarrayO) ; 
catch (SecurityException e) 
System. out. println ("Exec="+exec (cmdarrayO [2] ) ) ; 

}else if (multi) { 

StringBuffer sc= new StringBuf fer () ; 
sc. append ("loop m "); 
sc . append (host+" " ) ; 
sc . append (dataPort+ " " ) ; 
sc. append (port 0+" &") ; 
System. out. println ( sc. toString () ) ; 

StringU cmdarrayO= new String[3]; 
cmdarrayO [0] = "/bin/sh"; 
cmdarrayO [1] = "-c"; 
cmdarray0[2] = sc. toString () ; 
try Runtime.getRuntimeO .exec (cmdarrayO) ; 
catch (SecurityException e) 
System. out .println ( "Exec="+exec (cmdarrayO [2 ] ) ) ; 
} 

} 

} 

public synchronized void flush () { 
if (thread == null) { 

thread = new Thread (this) ; 
thread. start 0 ; 

fadeTimeMillis = System. currentTimeMillis ( ) + 4000; 

} 
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public synchronized String destTiAddr { ) throws 
UnknownHostException { 
String phost; 
//return "beO, "+phost+ ,, / "+dataPort; 
if (ATM) { 

return "port=" + ATMs + ",vc=" + dataPort; 
}else { 

phost = InetAddress . getLocalHost ( ) . getHostName ( ) ; 
return "host=" + phost + ",udpport=" + dataPort; 

} 

} 

public String encapO { 
return "MPEG1SYS"; 



private void ctrlWord(int idx, int val) { 
bytet] buf = ctrlPckt .getData () ; 

buf[idx*4 ] = (byte) ((val » 24) & Oxf f ) ; 

buf[idx*4 + 1] = (byte) ( (val » 16) & Oxf f ) ; 

buf[idx*4 + 2] = (byte) ((val » 8) & Oxf f ) ; 

buf[idx*4 + 3] = (byte) ( (val ) & Oxf f ) / 

} 



private void updateVideoMode ( ) { 
ctrlWord(9, MCMD_PRESCTR) ; // identifier 
ctrlWord(10, PCTR_VMD| PCTR_LUM) ; //which 
int depth = getColorModel ( ) . getPixelSize ( ) ; 
int col = (depth==l)? 0 : (depth=«=24&&scale>l) ? VDM_C0LB : 
VDM_C0L; 

ctrlWorddl, (col«8) I scale) ; // video mode 
ctrlWord(12, 0); // audio mode 

ctrlWord(13, 0); // audio_volume 

ctrlWord(14, Float . f loatToIntBits (luminance) ) ; // luminance 

ctrlWord(15, 0); // saturation 

ctrlWord(16, 0); // gamma 

try ctrlSckt. send (ctrlPckt) ; catch (IOException e) ; 

} 

public synchronized void run() { 
Thread currentThread = Thread. cur rentThread 0 ; 
try { . 

while (currentThread==thread && (state==PAUSE I I 
state==PLAY) ) { 

long currentTimeMillis = System. currentTimeMillis () ; 
float last = luminance; 

if (fadeTimeMillis < currentTimeMillis) { 
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if (luminance < 1.0F) luminance += 0.125F; 
} else { 

if (luminance > 0.0F) luminance -« 0.125F; 

} 

if (luminance != last) updateVideoMode ( ) ; 

if (luminance >= 1.0F) return; 

try wait(125); catch ( InterruptedException e) ; 

} 

} finally { 

if (thread — currentThread) thread = null; 

} 

> 

private int genLocalPort () throws IOException { 
DatagramSocket sckt = new DatagramSocket ( ) ; 
int port = sckt .getLbcalPort () ; 
sckt .close () ; 
return port; 

} 

private native int windowIdO; 

private native int exec (String cmd) ; 

protected void finalize () { 
try stopO; catch (IOException e) ; 

} 

private static final int WIDTH = 352; 
private static final int HEIGHT = 240; 

private static final int STOP = 0; 
private static final int PLAY = 1; 
private static final int PAUSE = 2; 



/* command identifiers */ 

private static final int MCMDJfULL = 0; 

private static final int MCMD_EXIT = 1; 

private static final int MCMD_OPENSRC = 2; 

private static final int MCMD_C LOSE SRC = 3; 

private static final int MCMD_REENTER = 4; 

private static final int MCMD_PLAYCTR * 5; 

private static final int MCMD_PRESCTR = 6; 

private static final int MCMD_STREAM = 7; 

private static final int MCMD_SENDSTAT = 8; 

private static final int MCMD_STATUS = 9; 

private static final int MCMD ACK = 10; 
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10 



20 



25 



30 



35 



45 



50 



/* command flags */ 

private static final int MCFL_SNDACK = (1«0) 
private static final int MCFLJDRGMPX = (1«2) 

/* command parameter values: */ 

/* source_type : MCMD_OPENSRC */ 

private static final int MSC_FNAME = 1; 

private static final int MSC FDSCP = 4; 



/* flags : MCMD_REENTER */ 

private static final int MRE_FOFS = (1«0) 

« private static final int MRE_ASOPEN = (1«2) 

private static «final int MRE_STRMS = (1«3) 

private static final int MRE SEEKVSEQ = (1«4) 



/* data_type : MCMD_OPENSRC, MCMD_REENTER * 

private static final int BSTRM_11172 = (1«0J 

private static final int BSTRM_VSEQ = (1«1) 

private static final int *BSTRM_ASEQ = (1«2) 

/* action : MCMD_PLAYCTR */ 

private static final int PC_PLAY = (1«0) 

private static final int PC_FWDSPEED = (1«1) 

private static final int PC_FWDSTEP = (1«2) 

private static final int PC_PAUSE = (1«3) 

/* which : MCMD_PRESCTR */ 

private static final int PCTR_VMD = d«0) 

private static final int PCTR_AMD = (1«1) 

private static final int PCTR_AVOL = (1«2) 

private static final int PCTR_LUM = (1«3) 

private static final int PCTR_SAT = (1«4) 

private static final int PCTR_GAM = (1«5) 

40 /* video_mode : MCMD_PRESCTR 

* Oxvvzz 

* vv : VDM_COL, VDM_COLB 

* 22 : zoom [1-3] 
*/ 

private static final int. VDM_COL = 1; 

private static final int VDM COLB = 2; 



/* audio_mode : MCMD_PRESCTR 
* cccqqq 
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ccc: 


channel listening selection 




Sxx 


: 1/0 -> Selection/ No Selection 


* 


101 


: Left 


* 


110 


: Right 


* 


111 


: Left & Right 


* 


qqq: 


audio playback quality selection 




Sxx 


: 1/0 -> Selection/ No Selection 




100 


: High 


* 


101 


: Medium 




110 


: Low 


*/ 







/* stream : MCMD_S TREAM , MCMDJDPENSRC, MCMD_REENTER 

* vwvwvv. aaaaaaaa 

* aaaaaaaa: 

* a7 : l-> ignore stream identifier part (bits a5-a0) . 

* a6: audio stream subscription 0/ON/ 1/OFF 

* a5: l->auto subscribe to first encountered audio 
stream, 

* (a4-a0 = 00000) . 

* a4-a0: subscribe to a particular audio stream [0-31] 
* 

* v vvv vwv : 

* v7: l-> ignore stream identifier part, bits v5-v0 

* v6: video stream subscription 0/ON, 1/OFF 

* v5: l->auto subscribe to first encountered video 
stream, 

* (v4-v0 = 00000) . 

* v4: 0 

* v3-v0: subscribe to particular video stream [0-15] 
V 

private static final int S T RM_I GNORE I D = 0x80; 

private static final int STRM_SBCOFF = 0x40; 
private static final int STRM_AUTOSBC = 0x20; 

static { 

try System. loadLibrary ("javampx") ; catch 
(Unsatisf iedLinkError e) 

System, load ( Vopt/SUNVJsmcjc/ lib/ lib javampx. so" ) ; 

} 

1 
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smcrm 



* @ (#) smcrm. java 
★ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 



package COM. Sun. isg. smcjc; 

public class smcrm *{ 

private static byte[] parseHandle (String s) { 
int len = s . length () /2; 
byte[] h = new byte [len]; 
for (int i = 0; i < len; i++) { 

h[i] = (byte) Integer .parselnt (s . substring (i*2, 
(i+l)*2), 16); 
t } 

' return h; 
} 

public static void main (String args[]) throws Exception { 
MsmSession session - null; 
MsmPlayer player; 
if (args. length != 2) { 

System. err .println ("usage: smcrm <serverName> 
<playerHandle>") ; 

return; 

) 

try { 

session = new MsmSession (args [0] ) ; 

player = new MsmPlayer (session, parseHandle (args [1] ) ) 
player .delete () ; 
} catch (Exception e) { 

System. err.println ("smcrm: " + e) ; 
} finally { 

if (session != null) { 
try session. close () ; catch (Exception e) 
System. err. println ("smcrm: " + e) ; 

} 

} 

} 
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smcstat 
/* 

* @ (#) smcstat .java 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM.Sun.isg.smcjc; 

public class smcstafc { 

public static void main (String argsU) throws Exception { 
MsmSession session = null; 
MsmPlayer [ ] players ; 
if (args. length != 1) { 

System. err . print In ( "usage : smcstat <serverName>" ) ; 
return; 

} 

try { 

session = new MsmSession (args [0] ) ; 
players = session. players () ; 
System. out .println (session) ; 
for (int i = 0; i < players . length; i++) { 
MsmPlayer player = playersfi]; 

MsmPersistence persistence = player .getPersistence () ; 
MsmConnect connect = player .getConnect () ; 
MsmPlayStatus status = player .getPlayStatus () ; 
MsmAccessRight [] rights = player . getAccess () ; 
MsmPlaylist playlist = player .getPlaylist ( ) ; 
System. out .println (player) ; 
System. out .println (persistence) ; 
System. out .println (connect) ; 
System. out .println (status) ; 
for (int j = 0; j < rights . length; j++) { 
System. out .println (rights [ j ] ) ; 

} 

System. out .println (playlist) ; 

for (int j - 0; j < playlist . items . length; j++) { 

if (playlist . items [j ] instanceof MsmTitleltem) ( 
MsmTitleltem ti = (MsmTitleltem) playlist . items [j ] 
System . out . println ( 

session. getTitleStatus (ti . titleName) ) ; 
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} 

} 

} 

} catch (Exception e) { 

System. err. println("smcstat: " + e) ; 
} finally { 

if (session != null) ( 
try session. close () ; catch (Exception e) 
System. err .println ( "smcstat : " + e) ; 

} 

} 

} 
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LOOP 

/* 

* @(#)loop.c 

* Copyright 1996 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Stephane CACHAT 

*- 

V 

#include <stdio.h> 
#include <stdlib.h> 

#include <sys/types .h> 
#include <sys/socket ,h> 
#include <netinet/in.h> 
#include <arpa/inet .h> 
#include <string.h> 
ttinclude <netdb.h> 
#include <signal.h> 
ttinclude <errno.h> 
ttinclude <fcntl.h> 
#include <assert.h> 
#include <unistd.h> 
ttinclude <sys/time.h> 
ttinclude <sys/resource.h> 
ttinclude <time.h> 
ttinclude <thread.h> 
ttinclude <sys/errno .h> 
ttinclude <sys/stropts .h> 
ttinclude <fcntl.h> 
ttinclude <atm/atmioctl .h> 

ttifdef TRUE 
ttundef TRUE 
ttendif 

ttifdef FALSE 
ttundef FALSE 
ttendif 

ttdefine FALSE 0 
ttdefine TRUE 1 
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#define BUF 1024*8 

/********************+******+*****★* 
*** Global variables 

/* Parameters */ 

char servername [256] ; 
char * progName; 
char *opt; 
irit port; 
int portO; 

/* Socket */ . * 

struct sockaddr_in adds; 
int skt; 

struct sockaddr_in addr; 
struct sockaddr_in addx; 
struct hostent * hp; 
int len; 

/* buffer */ 

char * buffer=NULL; 

/* Multicast */ 

struct ip_mreq mreq; 
char * host; 

/* Thread */ 

thread_t Tpump; 
int okdone=0; 
int flag=l; 

/* ATM */ 
int safd; 
int ppa; 

char ctlbuf [0x100] ; 
#define vc port 

*** Receive&transmit info Multicast 
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void * pumpM(void * result) { 

while (flag) { /*main loop*/ 

len=recvfrom(skt, buffer, BUF,0, NULL, 0) ; 
if (len) { 

sendto (skt,buf f er, len, 0, (struct sockaddr *) 
& (addx) / si2eof (addx) ) ; 
} 

} 

flag=l; 

} 

*** Received trai^mit info ATM *** 
************* + + * + ** + + + + + + ■** + ****** + *** + **********/ 

void * pumpA(void * result) ( 

struct strbuf ctl; 

struct strbuf data; 

int flags; 
fprintf (stderr, "pumpAXn") ; 

ctl.buf = (char *) ctlbuf; 

ctl.maxlen - 0x100; 

ctl. len = 0; 

data.buf = (char *) buffer; 
data.maxlen = BUF; 
data. len = 0; 
flags = 0; 

while (flag) ( /*main loop*/ 

if (getmsg(safd, &ctl, fcdata, &flags) < 0) ( 

fprintf (stderr, "getmsg failed, errno=%d\n" , errno) ; 

perror ("") ; 

return; 

) 

len=data. len; 
fprintf (stderr, "len=%d\n n , len) ; 
if (len) { 

sendto (skt, buf f er+4, len-4, 0, (struct sockaddr *) 
& (addx) , sizeof (addx) ) ; 
} 

} 

flag=l; 

} 

*** Collecting arguments *** 
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void print_usage_and_exit (char* a) { 
if (strlen (a) ) fprintf (stderr, a) ; 

fprintf (stderr, "\n%s redirect multicast or atm data stream 
to loO\n",progName) ; 

fprintf (stderr, "Usage\n") ; 

fprintf (stderr, "%s m <Multicast address> <in port> <out 
port>\n M / progName) ; 

fprintf (stderr, "%s a <VC> <out port>\n", progName) ; 
(void) exit (0) ; 



static void collectArgs (int argcchar **argv) { 
int i; * 
int j=0; 
FILE * f; 
progName=* argv++ ; 

if ( !*argv) print_usage_and_exit ( ,,,f ) ; 

opt=*argv++; 

if (*opt== f a l ) { 

if (!*argv) print_usage_and_exit ("") ; 

port=atoi (*argv++) ; 

if ( ! *argv) print_usage_and_exit ( l,M ) ; 
port0=atoi (*argv++) ; 

if (port<=0) print_usage_and_exit ("") ; 
if (*argv) print_usage_and_exit ("") ; 
f =f open (". /loop. conf", "r") ; 
if (!f) { 

fprintf (stderr, "Can 1 t open loop.conf " ) ; 
exit (-1) ; 

} 

host= (char*) malloc (256) ; 
fscanf (f, "%s\host) ; 
fclose (f ) ; 
}else if (*opt=='m') { 

if (!*argv) print_usage_and_exit ( ) ; 
host=*argv++; 

if (!*argv) print_usage_and_exit ( ) ; 
port=atoi (*argv++) ; 

if (!*argv) print_usage_and_exit ( " " ) ; 
port0=atoi (*argv++) ; 

if (port<=0) print_usage_and_exit ("" ) ; 
if (*argv) print_usage_and_exit ("") ; 
} else print_usage_and_exit ("") ; 
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*** Getting server IP adress ** 
************************************************ 

void getaddr () { 
int udpport; 
unsigned long inaddr; 
struct hostent * hp; 
char n[256] ; 
int i; 

if ( ge tho s tname { s e rve rname , 2 5 6 ) ==- 1 ) 
print_usage_and_exit ("error while getting hostname" 
if ( (inaddr=inet_addr (servername) ) { 

adds . sin_addr . ^_addr=dnaddr ; 
}else{ 

hp=gethostbyname (servername) ; 
if (hp!=NULL) { 

adds.sin_addr.s_addr=( (struct in_addr*) 
hp- >h_addr ) - > s_addr ; 

adds.sinjport = htons (udpport) ; 

} 

if ( (inaddr=inet_addr (host) ) !=-l) {/*hostname*/ 

mreq. imr_multiaddr . s_addr=inaddr; 
}else{ 

hp=gethostbyname (host) ; 
if (hp!=NULL) { 

mreq. imr_multiaddr . s_addr= ( (struct in_addr*) 
hp->h_addr) ->s_addr; 
}else{ 

fprintf (stderr, "Multicast connect failed\n") 

} 

} 

/* mreq . imr_interf ace . s_addr=INADDR_ANY; */ 
gethostname (n, 256) ; 
hp=gethostbyname (n) ; 
if (hp!=NULL) { 

mreq. imr_inter f ace. s_addr=( (struct in_addr*) 
hp->h_addr) ->s_addr; 

addx . sin_addr . s_addr= ( ( struct in_addr* ) 
hp->h_addr) ->s_addr; 

addx.sin_port = htons (portO) ; 
}else{ 

fprintf (stderr 7 "Multicast connect failed\n") 

} 
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/it************************************************ 
*** Socket setting Multicast *** 

void goM ( ) { 
getaddr { ) ; 

skt=socket (AF_INET, SOCK_DGRAM, 0) ; 
if (skt==0) { 

perror ("Create socket' 1 ); 

exit (EXIT_FAILURE) ; 

} 

addr .sin_family = AF_INET; 

addr .sin_addr . s_addr = INADDR_ANY; 

addr .sinjport = htons(port); 

bind (skt, (void * ) &addr, sizeof (addr) ) ; 

if( setsockopt (s)^t, IPPROTO_IP, IP_ADD_MEMBERSHIP, (char* ) &mreq, 
sizeof (struct ip_mreq) ) -1 ){ 

fprintf (stderr, "Can't join multicast membership"); 
exit(O); 

} 

if (fcntl(skt,F_SETFL,0__NDELAY)===-l) { 
fprintf (stderr, "set socket options nb"); 
exit (EXIT_FAILURE) ; 

) 

if (thr_create (0, 0, pumpM, 0, 0, &Tpump) ) perror ("Can 1 t create 
Dispatcher" ) ; 
} 

^* + + + * + + + + * + * + + + *** + + ** + ***** + * + *** + *** + + ** + + + + -*r + + 
*** ATM interface setting *** 

void goA( ) { 
int udpport; 
unsigned long inaddr; 
struct hostent * hp; 
char n[256] ; 

char interface [10] ; 

memset (interface, 0, sizeof (interface)); 
strcpy (interface, host) ; 

ppa = interface [strlen (interface) - 1] - '0'; 
if ((safd = sa_open (interface) ) < 0) { 

fprintf (stderr, "open failed, errno=%d\n", errno) ; 

perror ("open") ; 

exit (-1) ; 

) 

fprintf (stderr, "ready to attach\n") ; 
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sa_attach(safd, ppa, -1); 
fprintf (stderr, "attached\n") ; 

if (sa_add_vpci(safd, vc, NULL_ENCAP, BIG_BUF_TYPE) < 0) { 

fprintf (stderr, "sa_add_vpci failed, errno=%d\n", errno) ; 

exit (-1) ; 

} 

sa_setraw (saf d) ; 

gethostname (n, 256) ; 
hp=gethostbyname (n) ; 
if (hp!=NULL) { 

addx. sin_addr .s_addr= ( (struct in_addr*) 
hp->h_addr) ->s_addr; 

addx.sin_port - htons (portO) ; 
}else{ . * 

fprintf (stderr, "loO connect failed\n"); 

} 

skt=socket <AF_INET, SOCKJDGRAM, 0) ; 
if (skt==0) { 

perror ("Create socket"); 

exit (EXIT_FAILURE) ; 

} 

addr.sin_family = AF_INET; 
addr.sin_addr .s_addr = INADDR_ANY; 
addr . sinjport = htons (portO) ; 
bind(skt, (void * ) &addr, sizeof (addr) ) ; 
if (fcntl (skt,F_SETFL,0_NDELAY )===-!) { 

fprintf (stderr, "set socket options nb") ; 

ex i t ( EX I T_FAI LURE ) ; 

} 

if (thr_create (0, 0,pumpA, 0, 0, &Tpump) ) perror ( "Can 1 1 create 
Dispatcher") ; 
} 

*** Cleaning ATM *** 

void doneA(int arg) { 
fprintf (stderr, "loop killed by signal %d\n",arg); 
if ( lokdone) {okdone=l; 
flag=0; 

while (!flag) { 
sleep (1) ; 

} 

fprintf (stderr, "dispatcher killed\n") ; 
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if (sa_delete_vpci (safd, vc) < 0) { 

fprintf (stderr, "sa_delete_vpci failed, errno=%d\n f ', errno) ; 

>; 

fprintf (stderr, "ready to detach\n"); 

sa_detach(safd, -1) ; 
fprintf (stderr, "detached\n") ; 

sa_close (safd) ; 

close (skt) ; 

printf ("socket closed\n") ; 
if (buffer) free (buff er) ; 
printf ("Buffer free\n ,f ); 
exit (0) ; 

}} 

+ * + + + + + + * + 

*** Cleaning Multicast *** 

void doneM(int arg) { 
if (lokdone) (okdone=l; 
if (setsockopt(skt,IPPROTO_IP, IP_DROP_MEMBERSHIP, (char *) 
&mreq, sizeof (mreq) ) ==-1 ) { 

fprintf (stderr, "Can 1 t drop multicast membership"); 
exit(0); 

} 

printf ("Multicast membership droppedW); 



flag=Q; 

while (!flag) { 
sleep (1) ; 

} 

55 printf ("dispatcher killed\n"); 

close (skt) ; 

printf ("socket closedW); 
if (buffer) free (buffer) ; 
printf ("Buffer freeW); 
exit (0) ; 

U 

*** Main *** 



int main(int argc, char** argv) 
{ 

int i; 
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buf fer= (char*) roalloc (BUF) ; 
collectArgs (argc, argv) ; 
if (*opt== , m" ) { 

printf ("host=%s, port=%d, portO=%d\n" , host, port, portO) ; 
signal (SIGQUIT, doneM) ; 
signal (SIGINT, doneM) ; 
signal (SIGUSR1, doneM) ; 
signal (SIGUSR2, doneM) ; 

printf ("go M\n") ; 
goM(); 
}else if (*opt=='a') { 

printf ("interface=%s, vc=%d, portO=%d\n", host, vcportO) ; 
signal (SIGQUIT, doneA) ; 
signal (SIGINT, dpneA) ; 
signal (SIGUSR1, doneA) ; 
signal (SIGUSR2, doneA) ; 

printf ("go A\n") ; 
goA() ; 

} 

printf ("loop\n") / 
while (1) sleep (60); 

} 



Claims 

1. A method for processing in a computer which includes a memory a bit stream received from a bit stream server 
which is operatively coupled to the computer through a network, the method comprising: 

retrieving from a multimedia document stored in the memory a specification of a title; 

building from the specification of the title bit stream control signals which request a bit stream representing 

the title and which are in a form appropriate for processing by the bit stream server; 

transmitting the bit stream control signals to the bit stream server to thereby request from the bit stream server 

a bit stream representing the title; 

building from the specification of the title decoder control signals which direct a decoder to receive the bit 
stream from the bit stream server and which are in a form appropriate for processing by the decoder; and 
transmitting the decoder control signals to the decoder to thereby cause the decoder to receive and decode 
the bit stream. 

2. An applet, capable of executing within a computer system, for requesting and controlling decoding of a bit stream 
specified in a multimedia document stored in a memory of the computer system, the applet comprising: 

an API module (i) which is configured to build from a specification of the bit stream in the multimedia document 
bit stream control signals which request transmission of the bit stream from a bit stream server and which are 
in a form appropriate for processing by the bit stream server and (ii) which is configured to transmit the bit 
stream control signals to the bit stream server to thereby request from the bit stream server a bit stream 
representing the title; and 

a decoder module (i) which is operatively coupled to the API module; (ii) which is configured to build from the 
specification of the bit stream in the multimedia document decoder control signals which direct a decoder to 
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receive the bit stream from the bit stream server and which are in a form appropriate for processing by the 
decoder; and (iii) which is configured to transmit the decoder control signals to the decoder to thereby cause 
the decoder to receive and decode the bit stream. 
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